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INTRODUCTION 


The VMS Utilities and Commands course is a lecture/lab course designed to show you how to 
perform typical nonprivileged operations on a VMS system by entering commands at a terminal. 


The course has been organized into a series of units, or modules, each designed to cover a 
well-organized topic, or group of topics. Each module contains its own learning objectives. 


Suggested Laboratory Exercises are provided to allow you to reinforce, through practice, your 
knowledge of the topics covered. 


COURSE DESCRIPTION 


The VMS Utilities and Commands course describes the working environment of a VMS system 
and introduces frequently used operations that you can perform by entering commands at an 
interactive terminal. 

Among the major topics covered by the course are: 

¢ Creating, editing, and maintaining text files 

¢ * Submitting batch and print jobs 

¢ Writing and using command procedures 

¢ * Using logical — and symbols to tailor your working environment 

« Using private disk and tape volumes to back up your own files 


¢ Communicating with other users on a system and network 


¢ Using online and printed VMS documentation to obtain information 
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PREREQUISITES 


There are no prerequisites for this course. However, you can derive the greatest benefit from 
this course if you have: 


* A basic knowledge of a computer system. 


¢ The ability to work on a system using an interactive terminal. 
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COURSE GOALS 


To effectively use the nonprivileged facilities of the VMS system, you should be able to perform 
the following operations: | | 


¢ Use online and printed documentation to obtain information about VMS features 
- Understand the basic hardware and software components of a VMS system 


¢« ¥* Enter syntactically correct DIGITAL Command Language (DCL) commands to obtain infor- 
mation from the system 


¢ Create files using a text editor (EDT or EVE) 

¢ Communicate with other users and system operators 

¢ Organize files into subdirectories and maintain them 

« Use logical names, symbols, and key definitions to modify your working environment 
- * Create and use command procedures to automate repetitive tasks 


- ¥Use the printer to produce hard copies of files and use the batch processing facility to 
execute command procedures 


« Use private disk and tape volumes to back up and store personal files 


* Follow the program development steps to produce executable programs on a VMS system 
(OPTIONAL) 
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COURSE NONGOALS 


This course introduces the concepts and command sequences necessary to achieve the course 
goals. You will not learn to use the following: 


The MCR command language interpreter or other RSX utilities that reside on your system. 


The syntax of BASIC, COBOL, FORTRAN, or MACRO. The module dealing with program— 
ming gives a generic overview of the various programming steps. It is recommended that 

students enroll in a program—specific course to obtain the greatest benefit from a program-— 
ming language. 


The use of commands or utilities that require privileges beyond the most basic privileges 
granted to users of your system. 


The use of commands that manipulate a multiprocess environment. 


VMS programmed system services, common run—time library routines, or other features that 
require direct interaction with the operating system. 


Use of programmer productivity tools, databases, word processors, or any other optional 
software. 


References to and materials associated with VAXcluster systems. 


Advanced command procedures, such as error handling, file /O, dynamic arrays, CALL and 
GOSUB commands. 


Any functions, commands, or information related to "system management." 


File applications, such as, sorting records within a file and merging files. 


_ xxii About This Course 


COURSE RESOURCES 


In addition to the VMS system itself, there are three major resources available to you for com- 
pleting this course: 


¢« This Student Workbook 
¢ The manuals of the VMS documentation set 


¢ Your /nstructor 
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DOCUMENTATION 


You should have access to the following manuals to complete this course: 
¢ Course Student Workbook 

* Guide to VMS Files and Devices 

¢ VMS DCL Dictionary 

¢ Guide to Using VMS Command Procedures 
¢ VMS Mail Utility 

¢ VMS Phone Utility 

« VAX EDT Reference Manual 


> VAX Text Processing Utility Manual 


VMS DCL Concepts Manual 


Cne complete VMS documentation set should be available for reference. 
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COURSE ORGANIZATION 


This iS a lecture course that includes structured laboratory sessions. Lecture sessions consist of 
instructor presentations and class discussions. Laboratory sessions consist of instructor demon— 
strations or directed individual study. You should try to complete the penlely exercises during 
the laboratory sessions. 


The material in the Student Workbook is divided into units, or modules of study. Each module 
covers one or more of the skills typically required by a nonprivileged user of a VMS system. 


A module contains the following instructional elements: 


- An introduction, which describes the purpose of the modules, provides some motivation 
for mastering its objectives, and outlines its contents. 


e One or more objectives, which describe the operations for which the module provides 
instruction. Objectives are designed to focus your study efforts on a selected number of 
skills. 


e A list of resources you may need to complete the unit. Some of these resources are 
distributed with this course; others are not. Since a complete document set is distributed 
with each VMS operating system, you should consult your course instructor for access to 
materials that do not come with this course. 


- The module text, which includes the following elements: 
— Descriptive text 


— Illustrations, which clarify the relationships among various elements of a VMS system, 
or summarize steps of a particular process 


— Tables, which summarize the operations covered by the modules, and list the commands 
needed to perform those operations 


— Examples, containing sample listings from actual terminal sessions 


There is also a Laboratory Exercises module, which provides the practice needed to master 
the objectives of each module. Solutions to the exercises are also provided. 
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COURSE MAP DESCRIPTION 


The course map shows how each module of the course is related to the other modules, and 
to the course as a whole. Prerequisite modules are those whose arrows in the map point into 
another module. 


Figure 1: Course Map 
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xxvi About This Course 


COURSE CONVENTIONS 


Table Table 1 describes the conventions used in the listings and tables of the Student Workbook. 


Table 1: Course Conventions 


Convention 


new terms, prompts 


<CTRL/X> 


SHOW QUEUE 


$ SHOW QUEUE/qualifier [queue—name] 


S SHOW QUEUVE/ALL ENTRIES SYSSPRINT 


[] 


Type vs. Enter 


Meaning 


Terms that are introduced for the first time and 
system prompts are printed in italics. 


Angle brackets indicate that you press a key 
on the terminal keyboard. For example, <RET> 
means to press the RETURN key. 


Press and hold the key labeled CTRL while you 
press another key (X). Many control key sequences 
have special meanings. 


Names of commands in text are shown in upper- 
case and bold. 


Formats and command syntax are shown in boid. 
Words in uppercase are required, and words in 
lowercase represent elements that you must re- 
place according to the description in the text. 


Actual examples of commands are shown in monospace 
type. 

Square brackets indicate that the enclosed item 

is optional. (Square brackets are not optional, 
however, in the syntax of some file specifications 
assignment statements.) 


When the word "type" is used in text, it means 
that you simply type a command. When the word 
"enter" is used, you must type the command and 
press the RETURN key. 
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MODULE 1 


HARDWARE AND 
SOFTWARE OVERVIEW — 


HARDWARE AND SOFTWARE OVERVIEW 1-1 








INTRODUCTION 


Ar me ET Lt ee POA ct A at 


programs, and data. The devices that compose the physical computer are called hardware. The 
programs that control the hardware and process the data are called the software. To perform 
job-related tasks on the system, you must use both the hardware and the software. 


This module provides an introduction to VAX hardware, and an overview of the VMS software 
environment. 


OBJECTIVES 


To work on a VMS system, you should be able to: 

- Identify the functions of each component of the hardware environment. 

¢ Identify and describe the functions of each component of the software environment. 
¢ identify elements that make up a process in the VMS environment. 


¢ Recognize the peripheral devices supported by VAX systems. 
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COMPONENTS OF THE HARDWARE ENVIRONMENT 


+ VAX computer hardware is divided into four subsystems 


° Each has a different function 


Figure 1-1: VAX Hardware Subsystems 
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MAIN 
MEMORY 






The Central Processing Unit (CPU) 


¢ Executes instructions one at a time 
- Some of the VAX family of processors include 
— MicroVAX Il #7 
— MicroVAX | 
— VAX-11/780 +” 
= VAX 8200 
— VAX 8600 


/— VAX 8700 
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The Console Subsystem > 
- HARD CODY TERMINAL) 


te, 


iy ta hee 
> Communicates directly with the CPU 


¢ Is primarily used for 
— Starting up and shutting down the system 
— Installing software 


— Remote hardware diagnosis 
Main Memory 
* Main memory is used to store instructions and data temporarily 


Input/Output Subsystem 


* Provides input to and output from the system 
¢ Consists of peripheral devices 
¢- Common peripherals include 

— Terminals 

— Printers 

— Disk drives 

— Tape drives 


¢« Refer to Appendix A for examples of peripheral devices 
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THE VMS OPERATING SYSTEM 


¢ The VMS Operating System is a collection of programs that 
— Control the operations of the system 
— Manage the system's resources 

- The operating system performs three major functions 


1. Provides the means for users to communicate with the hardware devices that make up 
the system 


2. Creates a working enviranment in which users can access the resources needed to 
perform tasks, without interfering with other users’ activities on the system 


3. Schedules the use of the CPU, physical memory, and peripheral devices to provide 
equitable access for all users, while using these resources as efficiently as possible 


¢ Typical activities of the operating system include 
— Loading programs and data into memory from storage 
— Scheduling the order of action by the CPU 
— Allocating resources, such as physical memory 


— Scheduling input and output (I/O) to other devices 
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DIGITAL Command Language (DCL) 


* The means by which a user communicates with the system 
> DCL uses common words for commands and qualifiers 
¢ These common words make it easier to 
— Remember DCL commands 
— Enter DCL commands at a terminal 
— Recognize and correct syntax errors 
¢ DCL commands can be used to 
— Perform file manipulation tasks 
— Display information about 


The status of the system 

Users on the system 

Devices connected to your system 
Resources available on the system 


— Execute user—written programs or system utilities 
- DCL commands are translated by the Command Language Interpreter (CLI), which 


— Interprets the DCL command for correct syntax. 


— Calls the VMS routines that perform the command 


1-8 HARDWARE AND SOFTWARE OVERVIEW 


Utilities 

Utilities are software tools that perform specified tasks. These utilities 
* Are provided with the VMS software 

¢« May have their own set of commands and command prompts 

¢ Perform a wide variety of tasks, Such as 


— Text editors 


EDT Editor 
Extensible VAX Editor (EVE) 


— Communication Utilities 


MAIL 
PHONE 


— Text Processors 





* Digital Standard Runoff (DSR) 
— Debugging and Programming Jools 


aa neh 9 LOL BATA 


VMS Debugger 
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Optional Layered Products 


¢- Layered products are available for VMS systems 
« These optional layered products 
—- Perform specific tasks that enhance the capabilities of the system 
— Are provided separately 
- Types of layered products include 
— Language compilers 
-—— Communications software 
— Diagnostics software 
— Office automation products 


— Data management tools 
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THE WORKING ENVIRONMENT 


oat. 
af 


The Process erate 


nm mA Fane en 


¢ The system uses processes to 
— Schedule the execution of programs by the CPU 
— Determine the availability of system resources 


— Allocate system resources 
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Components of a Process 


* Aprocess has four components 


etna 


_-—- The Hardware Context—Values prpiuanepeerapotn in the. ema registers that.describe. what 


Arse Rana AO SOLAN 


the process.is doing Come MT a7reee, ar smi! 


— The Software Context—Controls what the program is allowed to.do 
NER} 1S PD P 2Dert BAA Deal IGT Ala) ‘(fon NTE Ie UP” 


St MR oe pepe ene, 


; — Virtual Address Space—Process addresses are mapped. to 2_physical addresses 





ae 


“— The Program (Image) Contains instructions t to do the actual work 


aes el Rech nace, PARAS OAT IRE SOME TEE DES 


EXECUTING Sates 
« These components provide the srvironient used by the system to run an image 


Figure 1-2: Components of a Process 
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Process Types 


* Interactive Process 
— One of the most common process types 
— Created when a user logs in 
— Terminates when the user logs out of the system 
* Subprocess 
— Aprocess that uses some of the same resources as the parent process 
—— Subprocesses allow users to have several programs executing at once 


* Batch Process, 


— Created by the system so that it can execute a special file called a command procedure 


heatitemtin or toe 


a 


— Frees up your terminal for other work 


Pos ica iealll 2 
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“+The System User Authorization File (SYSUAF) 


- SYSUAF contains the information used to create a process. 


¢ It is used to determine all authorized users of the system. 


> 


PINEAL ERD AE Anse OAL Be — 


cludes: SYS URE. DAT «--—- (CONTAINS PASS Oo omOS9 Extd a iP TeEDO 
— User Identification Code.(UIC). The. UIC. is. used.to.determine.the owner of files and to 


Information about each user is placed in this file by the system manager. Information in— 





determine file access. 


— Default directory. This determines the disk and directory used by the user at login time. 
— Privileges. Privileges determine whether the user can perform a given task. 


— Priority. The process priority determines how a particular process will compete with 
other processes to get work done on the system. 
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SUMMARY 


There are four main functional subsystems of VAX computers: 

— The CPU - executes instructions. 

— The console subsystem — communicates with the CPU to monitor and control the system. 
-—— Main memory — stores data and instructions. 


— The I/O subsystem - consists of devices that provide input to and produce output from 
the system. These devices are referred to as peripherals. Peripherals include terminals, 
printers, disk drives, and tape drives. | 


The software environment is made up of several components: 


The VMS Operating System 

— Controls software on the system 

— Provides the means of communication with other hardware devices on the system 
— Schedules the allocation of resources and the execution of programs 

The user interface with the VMS system is the DIGITAL Command Language (DCL) 
— The means by which a user communicates with the system 

— Uses common English-like words 7 

— Interpreted by the Command Language Interface (CL!) 

Utilities are software tools that perform specific tasks 

— Provided with the system software 

— Include tools such as editors, text formatters, and communication utilities 
Optional Layered Products 

— Perform tasks beyond those of the system software 


— Must be purchased and installed separately 


The working environment is defined in terms of a process: 


The system creates and controls processes 


Information used to create processes is stored in the System User Authorization File 
(SYSUAF) 
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VAX system configurations can be classified as single processors and multiple—processor 
configurations. 


A single—processor configuration is any single VAX processor and its peripheral devices. 
There are three types of multiple-processor configurations: 

— Tightly—coupled multiprocessors 

— Networks 

— VAXcluster systems—configured midway between multiprocessors and networks 
Multiple—processor configurations consist of: 

— Processors 

— Peripheral devices 

— Communication devices 

— Transmission media 

— Terminal servers (optional) 

A local area network spans a limited geographical area. 

A wide area network spans a larger area. 


The important difference between a network and a VAXcluster system is that the sharing of 
information between nodes is much faster and easier in a VAXcluster system. 
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APPENDIX A—PERIPHERAL DEVICES 


Terminals 


¢« Used to communicate with the computer 
* ‘Two types of terminals 
— Hardcopy 


— Video 


Figure 1-3: Sample Hardcopy and Video Terminals 
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Printers and Printer/Plotters 


- Printers provide output from the system 
* Various sizes and types include 
— Line printers (high speed) 
— Letter quality printers (high-quality print) 
— Laser printers (high-quality print and graphics) 


¢  Printer/plotters are used for graphic output 
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Figure 1-4: Sample Printers and Printer/Plotter 
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Disk Drives 


* Record and read dete on magnetic disks 
- Are sometimes called mass storage devices 
« . Disks used in the drives 

— Are called storage media 


— Usually store frequently used data fasne es MAM rue 


eee TW aR YOR 


T eratalal 


— Are either removable or fixed 





— Various types of removable disks include 


Cartridges 

Disk packs 

Diskettes 

CDROM — €xse eevee 
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Figure 1-5: Examples of Disks 
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Figure 1-6: Examples of Disk Drives 
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Tape Drives 


- Record and read data on magnetic tapes 
- Tapes usually store — 

— Backup copies of data 

— Infrequently used data 
¢ Two kinds of tapes 

— Reel Tapes. 


— Tape cartridges 
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Figure 1-7: Examples of Tape Media 
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Figure 1-8: Sample Tape Drives 
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APPENDIX B—SYSTEM CONFIGURATIONS 


You can build different configurations with 

—- VAX processors 

— Peripheral devices 

system configurations can be classified as 

— Single processors 

— Multiple—processor configurations 

A system can be: 

—  A-single VAX processor and its peripheral devices 


— Acollection of VAX processors 


Single Processor Configurations 


Any single VAX processor and its peripheral devices 
The family of VAX processors includes 

— VAX 8700 

— VAX 8650 

— VAX 8250 

— VAX-11/785 

— VAX-11/780 

= MicroVAX 3000 


— MicroVAX Il 
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Figures 1-9 and 1-10 are not drawn to scale. 
Figure 1-9: MicroVAX Il 
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Figure 1-10: VAX 8600 
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Multiple-Processor Configurations 


¢ Two or more communicating processors 
¢ There are three classifications 
— Tightly—coupled multiprocessors 
— Networks 


— VAXcluster systems 
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Tightly—Coupled Configurations 


- Share operating system code 
¢ Cannot operate independently 
¢ Provide high performance 


¢ Used in compute—intensive applications ee eee eee 
3 . ERSTE OM Ae 8 Pee Ges 
oe se. } eo = 1G Se ae TEs Oe, Se 5 


- Example: VAX 8820 ° 


= Two CPUs share memory by means of a VAXBI system bus 


— Master processor runs the VMS operating system and controls the attached processor 


Figure 1-11: A Tightly-Coupled System Configuration 
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VAXcluster Systems 


« Flexible multiprocessing system 
«  VAXcluster systems can share 
— Disk and tape devices 
— Acommon file system 
¢ {In addition to providing the functions of a network, VAXcluster systems provide 
— Higher availability of system resources 
— Faster and easier sharing of information and resources between nodes 
¢« A VAXcluster system configuration 
— May have hardware similar to a network configuration 
— May contain the same components as a network 


VAX processors 
Communication devices 
Transmission media 
Terminal servers 
DECnet software 


— May have other VAXcluster system specific hardware 


Hierarchical Storage Controller (HSC) 
Computer Interconnect (Cl) 


:, ee 
- Major difference between a VAXcluster system and.a network is VMS cluster software, which 
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Figure 1-12: VAXcluster System Structure 
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Notes on Figure 1—12: 


1. The expanded VAXcluster system has added a third VAX system (with a local disk), and 
two HSC controllers with two dual—ported disks connected to them. 


2. Any of the three VAX systems in the expanded VAXcluster system can mount the two disks 
that are connected to the HSC controllers. HSC disks are-more available to users than local 
disks, because HSC disks are not dependent upon the availability of any processor. 


3. The disks are dual—pathed to the HSC controllers, further increasing the disks’ availability in 
the VAXcluster system. If one HSC fails, all traffic to connected disks automatically switches 
to the second HSC. 
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NETWORKS 


* Consist of two or more communicating processors 


> VMS system can be connected to 


Other DIGITAL systems 


Other manufacturers’ systems 


* DIGITAL—to-DIGITAL networks are established using 


Two or more processors 
Hardware communication devices 
Data transmission media 
Terminal servers (optional) 


DECnet software 


¢ DECnet software enables communication between networked systems 


- A-user logged in to one of these systems can 


Communicate with a user who is logged in to another node 


Access disk files stored on another node 


— Write programs that communicate with programs running on another node 
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Figure 1-13: A DECnet Network 
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Notes on Figure 1-13: 
1. This network consists of two processors, or nodes. Each node has a disk drive. 


2. Each processor in the network has an attached communication device. The communication 
devices are connected by a data transmission medium. 


3. Access to disk files stored on a given node depends upon the availability of that node. For 
example, if Processor A is shut down, any disk files stored on Processor A's disk become 
inaccessible to users logged in to Processor B. 
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MODULE 2 
GETTING STARTED 


GETTING STARTED 2-1 


INTRODUCTION 


To perform daily tasks on a VMS system, you’ must issue instructions written in the DIGITAL 
Command Language (DCL). DCL consists of a vocabulary and rules of grammar, as in any 
language. 


The DCL vocabulary includes commands, parameters,.and.qualifiers, all of which perform func— 
tions “similar to those of verbs, nouns,, adverbs, and adjectives in English. When | YOu. arrange 


them t to. . form: a command line, ‘the « Command Language Interpreter {CLI) causes, images, ‘to be 
run run to perform | the requested actions: = ts 


This module introduces you to: 
¢* Communicating with the VMS system by using the DIGITAL Command Language (DCL) 


¢« Using both online and printed VMS documentation 
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OBJECTIVES 


To effectively use the interactive features of the VMS system, you should be able to: 
¢ Log in and log out of the system. 
¢ Use DCL to perform work on the user’s behalf. 


¢ Use the VMS HELP facility and VMS documentation to obtain information about DCL com- 
mands and error messages. 


¢ Interpret any VMS error messages and issue a corrected command by using the DCL 
command-line editor. 


¢ Obtain and interpret information about the terminal, process, and system. 
RESOURCES 


e VMS General User’s Manual 


« VMS DCL Dictionary 
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LOGGING IN TO A VMS SYSTEM 


Figure 2—1: Enter a Valid User Name and Password 
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USER NAME AND PASSWORD 


Your User Name: 
« Consists of 1 to 12 characters 


* ls assigned by the system manager 


Your Password: 
¢« Consists of 1 to 31 characters 
¢ Legal characters include: 

— Athrough Z 

— 0 through 9 

— $ (dollar sign) 


— _ (underscore) 
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BEGINNING AND ENDING A TERMINAL SESSION 


To log in to the system: 
- Press the RETURN key (<RET>) on the terminal keyboard. 
« In response to the prompt Username:, type your user name, then press <RET>. 


¢ In response to the prompt Password:, type your password, then press <RET>. The system 
does not display your password. 


To log out of the system: 


« At the DCL prompt ($), type LOGOUT and press <RET>. 


GETTING STARTED 2-7 


Example 2-1: How to Log In and Log Out 


VAX/VMS SUPER 

Username: SMITH 

Password: 

Welcome to VAX/VMS SUPER 

Last interactive login on Wednesday, 30-DEC-1987 10:27 


$ LOGOUT/FULL 


SMITH logged out at 5-JAN-1988 10:53:51.92 

Accounting information: 

Buffered I/O count: 46 Peak working set size: 333 

Direct I/O count: 24 Peak page file size: 1969 

Page faults: 496 Mounted volumes: 0 

Charged CPU time: 0 00:00:02.51 Elapsed time: 0 00:00:18.42 
NOTE 


The /FULL qualifier of the LOGOUT command displays a summary of the accounting 
information for the terminal session. $ LOGOUT<RET> does not display any information. 
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DCL COMMAND FORMAT 


Figure 2-2: The Elements of a Command Line 
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COMMAND LINE CONSTRUCTION 


¢ One or more spaces or tabs separate commands, command options, and parameters from 
each other. 


¢ Slash marks (/) separate qualifiers from commands and parameters. 
«Commas (,) separate elements in a parameter list. 


¢ Pressing <RET> passes the command line to the DCL CLI for execution regardless of the 
cursor position on the line. 
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Table 2—1: Elements of DCL Commands 


Command Element 


Command Line 


Definition 


A command line is the complete specification of a DCL command. 
One command line can consist of up to 1024 characters. 


(NOTE: By entering a hyphen (—) prior to pressing <RET>, you can 
enter the command line in segments. Each command line segment 
can consist of up to 256 characters. The system concatenates the 
segments into one DCL command prior to interpreting the com- 
mand.) 


Required Elements of a Command Line 


Verb 


Parameter 


The verb of the command line is like the verb of a sentence in 
English. It specifies the action of your request. The verb usually 
consists of one word. 


Example: $ HELP 


Parameter(s) receive the action of the verb, much like the object 
does in an English sentence. 


Example: $ PRINT FILE1.TXT 


In the instruction PRINT FILE1 . TXT, PRINT is the verb and FILE1.T> 
is the parameter. 


Optional Elements of a Command Line 


Qualifier 


Value 


The quailifier(s) of the command line describe or modify the action 
taken by the verb. A slash (/) precedes each qualifier. You can 
place qualifiers after the verb or after a parameter. (Some qualifiers 
accept one or more values.) 


Format: /quallfier[=(valuef[,...])] 
Example: $ sHow PROCESS/ALL 


The qualifier /ALL modifies the action. (There are three types of 
qualifiers. For an explanation of the qualifier types, refer to Table 
2-2). 


A value assigns a specific quantity to a qualifier. If you specify 
more than one value, you must separate the values with commas 
and enclose them in parentheses. 


Example: $ pRINT/COPIES=2 FILE1.TXT 


In the above instruction, /COPIES=integer is a qualifier to the verb 
PRINT. The value of the qualifier is the integer 2. 
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Table 2-1: Elements of DCL Commands (Cont) 


Definition 


Command Element 


Optional Elements of a Command Line 


$ 


> Label: 


When you are in interactive mode, the DCL CLI ignores the dollar 
sign. However, the dollar sign must precede commands you place 
in files. (This technique will be discussed in the Batch and Print 
Jobs module and the Command Procedures module.) 


The exclamation mark (!) indicates a comment. The system dis— 
regards anything on a command line following an exclamation 
mark. (The exclamation mark helps document commands you 
place within a file.) 


Examples: 
$ !The DCL CLI ignores this comment line 
S$ SHOW PROCESS !This comment is ignored 


The label is a character string that identifies a particular line in a 
file that contains DCL commands. Such a file is referred to as 
a command procedure. You should use labels only in command 
lines within command procedures. 
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a Table 2-2: The Three Types of DCL Qualifiers 


Qualifier Type 


“Command Qualifiers 


4 


Positional Qualifiers 


~ Parameter Qualifiers 


Comments 


Command qualifiers have the same meaning regardless of where 
they appear in the command line. 


Examples: 
$ PRINT/HOLD FILE1.TXT OF 
$ PRINT FILE1.TXT/HOLD 


since /HOLD is a command qualifier, the above two commands have 
the same effect. Both commands place the request in a hold state. 


Positional qualifiers have different meanings depending on where 
they appear in the command line. 


Example: 
S$ PRINT/COPIES=2 FILE1.TXT, FILEZ.TXT 


A positional qualifier placed after the verb, but before the first pa- 
rameter, affects the entire command line. Therefore, this command 
requests the printing of two copies of FILE1.TXT and two copies of 
FILE2. TXT. 


$ PRINT FILE1.TXT/COPIES=2, FILE2.TXT 


A positional qualifier placed after a parameter affects only that pa- 
rameter. Therefore, this command line requests the printing of two 
copies of FILE1.TXT and one copy of FILE2. TXT. 


There are several types of parameter qualifiers. Refer to the com- 
mand descriptions in the VMS DCL Dictionary for the names and 
types of parameter qualifiers that can be used with each command. 
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DCL FEATURES 


Table 2—3: Features of DCL 


Feature Example Description 
~ Continuation $ PRINT/COPIES=2 - The hyphen continues a command 

S$ FILE1 TXT, FILED /TxT = line over more than one line of in- 
_$ FILE3.TXT, FILE4.TXT put. 

Abbreviation $ LOGOUT ! These are You can abbreviate commands and 
$ LOGO ! equivalent keywords to four or fewer charac- 
$ LO ters. 

Prompting $ PRINT <RET> Type a command and-press <RET>. 
File: FILE1.TXT DCL will prompt for the required and 


optional parameters. 
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EDITING A DCL COMMAND LINE 


To accomplish various tasks, you will have to perform many of the following operations on a 
DCL command line: 


Move the cursor 

Add or delete data from the command line 
Recall a previously issued command line 
Control information displayed at your terminal 


Terminate an operation 


Table 2—4: Moving the Cursor 


Special 
Operation — Function Key Comments 
Moving the Cursortothe Left LEFT ARROW Moves the cursor one character to the 
CTRL/D left. Holding the LEFT ARROW key 
down moves the cursor until the key is 
released. 
Moving the Cursor to the Right RIGHT ARROW Moves the cursor one character to the 
CTRL/F right. Holding the RIGHT ARROW key 
down moves the cursor until the key is 
released. 
«Moving the Cursor to the Be- = CTRL/H Moves the cursor to the beginning of the 
* ginning of the Line line. 
.. Moving the Cursortothe End CTRU/E Moves the cursor to the end of the line. 


of the Line 


2-14 GETTING STARTED 


Table 2-5: Changing Data on the Command Line 


Operation 


Deleting a Character 


‘xDeleting a Word 


A 


Deleting the Line 


* Clearing the Line and the 
Type-—Ahead Buffer 


Replacing a Character 


¥ Inserting a Character 


special 
Function Key 


DELETE 


CTRL/J 


CTRL/U 


CTRUX 


text... 


CTRL/A 


Comments 


Deletes the character to the left of the 
cursor. (Note that on a hardcopy ter- 
minal the system responds by typing 
a backslash (\) followed by the delete 
character.) 


Deletes the preceding word. 


Erases all characters to the left of the 
cursor. When the cursor is at the end 
of the line, pressing the CTRL/U key se— 
quence erases the entire command line. 


Discards the current line and deletes 
data in the type—ahead buffer. 


Pressing any keyboard character causes 
that character to replace the character 
originally at the cursor position. This is 
referred to as the OVERSTRIKE mode 
of operation. OVERSTRIKE mode is the 
default data entry mode. 


CTRL/A changes the terminal's data en- 
try mode from OVERSTRIKE mode to 
INSERT mode. When you press any 
keyboard key in INSERT mode, the orig— 
inal text moves to the right, making room 
for the new character(s). If you are 
in INSERT mode, CTRL/A changes the 
terminal’s mode back to OVERSTRIKE. 
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Table 2—6: Recalling a Previously Issued Command Line 


special 
Operation Function Key 
Recalling the most recent UP ARROW 
commands CTRL/B 


Recalling recently entered DOWN ARROW 
commands 


Refreshing aDCL command CTRL/R 
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Comments 


Consecutively recalls the last command 
passed to the DCL CLI. Commands 
used for recalling previously entered 
commands from the command buffer 
are not retained. 


Recalls recently entered commands from 
the command buffer. After recalling 
the most recently entered command, 
pressing the DOWN ARROW key dis- 
plays a blank line. 


Redisplays the last unentered com- 
mand line on your terminal. (Note that 
on a hardcopy terminal, the system is- 
sues a <RET> prior to retyping the cur— 
rent command line.) 


* THE RECALL COMMAND 


The RECALL command displays previously-entered commands so that the user can re-use 
them. Up to 20 commands are stored in the RECALL buffer. 


Press <RET> after you have redisplayed a command to have the system execute that command. 


Table 2-7: Recalling a Previous Command Line with the RECALL Command 


Operation 
» Displaying the RECALL buffer 


yu Recalling the third most re- 
“cently entered command line 


a 


é Recalling the most recently 
entered PRINT command 


Erasing the RECALL buffer 


st 


Command/Quailifier 


RECALL/ALL 


RECALL 3 


RECALL PRINT 


RECALL/ERASE 


Comments 


The /ALL qualifier displays a numbered 
list of the commands you have en- 
tered. (UP TO ZO? 


Adding the parameter 3 to the RE- 
CALL command recalls the third most 
recently entered command line. 


The command parameter PRINT re— 
calls the last PRINT command entered. 


The /ERASE qualifier empties the con- 
tents of the RECALL buffer. 
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_ : Table 2-8: Controlling the Display of Information at Your Terminal 


} 


f 


writ many, 1! 

Bh, ioe 3 

as APB Vaud v2 
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-) wer fee 


mae Special 


2 & Operation Function Key Comments 


: 4% Redisplaying the CTRL/W Within some programs, CTRL/W refreshes 
P . Terminal Screen the current terminal display. (This key se- 


i. quence is useful within the EDT editor.) 


Suspending CTRL/S Suspends the display of information at your 
Terminal Output terminal. 


HOLD SCREEN The HOLD SCREEN key on VT200-series ter- 
minals also suspends the display. 


NO SCROLL The NO SCROLL key on VT100-series termi- 
nals also suspends the display. 
Resuming CTRL/Q Allows the program suspended by CTRL/S to 


Terminal Output 


HOLD SCREEN 


resume execution. 
Depressing the HOLD SCREEN key again af- 


ter halting the terminal display resumes the 
display on VT200-series terminalis. 


NO SCROLL Depressing the NO SCROLL key again after 
halting the terminal display resumes the dis— 
play on VT100-series terminals. 

, suppressing and CTRL/O Suppresses the current image’s output. The 
™ Resuming Terminal routine that generates the display continues 
Display er. to execute, returning control to the terminal 
ee eae when it terminates. The command echoes as 

Le Po Output off. Entering the key sequence a sec- 


ond time, enables the terminal to receive out- 
‘put again. The command echoes as Output 
on. 
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Table 2-9: Terminating an Operation 


Operation 


Canceling a Command Line 


Closing a File 


4 Determining Your 
Current Process 
Operation 


tee ahs 


Special 
Function Key 


CTRL/Y 


CTRL/C 


CTRL/Z 


CTRLUT 


Comments 


Cancels the execution of the current 
image. Control returns to DCL com- 
mand level. The command echoes as 


Interrupt. 


Within certain applications, CTRL/C can— 
cels command processing. CTRL/C 
echoes as Cancel. (When _CTRL/C is 
not enabled,.use-CTRLY) 


Indicates the end of a file entered at 
the terminal (for example, a file you 
opened with the CREATE command). 
In certain utilities, the CTRL/Z key se— 
quence is equivalent to the EXIT com- 
mand (for example, the MAIL Utility). 
The command echoes as Exit. 


Momentarily interrupts output to dis— 
play a line of statistical information about 
the current process. This key sequence 
is only informative. It does not affect 
the process operation. 
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GETTING HELP 


The Documentation Set 


¢ Contains 
— Information about the VMS system 
— Discussions of ee 
— Command examples 
— Definitions 
— Restrictions and problems 


e Refer to Table 2—10 as an index to documentation 
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<< Table 2-10: Manuals for Locating Information About Your System 


Topic VMS Manual 
Commands and Qualifiers VMS DCL Dictionary 
Descriptions See Prompts, Command Parameters, and File Qual- 
ifiers sections of a given entry 
Examples see Examples section of a given entry 
Syntax See Format section of a given entry 
Concepts of the Operating System VMS Glossary and Concepts Manual 
Definitions of Terms and Acronyms VMS Glossary and Concepts Manual 
Information and Error Messages Issued VMS System Messages and Recovery Procedures 
by the System Reference Manual 
Interpretations 


Suggested user actions 
Location of Major Topics in the Document Overview of VMS Documentation VMS Master In- 


Set dex 

Restrictions and Known Problems with Cur- VMS Version V5.0 Release Notes (Current Ver- 
rent Operating System Release sion) 

Software Available for Your Use A VMS Operating System (Current Version) Soft- 


ware Product Description is included with the VMS 
documentation set 
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The Online Help Facility 

To invoke the Help facility: 

- Enter the HELP command at the VMS prompt 
¢ Select a topic from the displayed list 


— Entering a topic printed in uppercase yields text on the DCL command of the same 
name 


— Entering a topic printed in lowercase yields text on a general topic 
¢ Press <CTRL/Z> to leave the Help facility 


¢ Table 2-11 lists commands for operating the Help facility 


2-22 GETTING STARTED 


Table 2—11: Using the DCL HELP Facility 


Operation 


Displaying a List of Available 
Help Topics 


Displaying Instructions on the 
Help Facility 


Displaying a List of Hints 


Displaying Information About 
the SHOW Command 


Displaying Information About 
the SHOW PROCESS Com- 
mand 


\. Redisplaying the Previous 
HELP Screen 


Returning to DCL Command 
Level 


Command 


S$ HELP 


S$ HELP INSTRUCTIONS 


S$ HELP HINTS 


S$ HELP SHOW 


S$ HELP SHOW PROCESS 


<RET> 


3 <CTRL/Z> 


Comments 


The HELP command lists the topics 
on which you can obtain information. 
The system responds with the Topic? 
prompt. 


Displays detailed instructions on how 
to use the Help facility. 


Produces lists of commands grouped 
by function. 


The SHOW parameter used with the 
HELP command produces an informa-— 
tive display on the SHOW command. 
The system responds with the prompt 
SHOW Subtopic?. 


By including the keyword PROCESS, 

you can have the system produce an 

informative display on the SHOW PRO- 
CESS command. SHOW PROCESS 

Subtopic? is the system prompt. 


Pressing the question mark key (?) re- 
displays the previous HELP message. 


Moves you one level closer to DCL 
level. When you are at the Topic? 
prompt, pressing <RET> returns you 
to DCL command level. 


CTRL/Z or EXIT returns you to DCL 
command level regardless of the HELP 
prompt. Both commands echo as EXIT. 
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CHANGING YOUR PASSWORD 


The DCL command SET PASSWORD changes your password. When changing your password, 
user input is not echoed at the terminal. You must enter the new password twice. If the two 
entries do not match, the password does not change. 


Example 2-2: Changing Your Password 


$ SET PASSWORD 


Old password: QUINOA 
New password: FERMATA 
Verification: FERMATA 


Note that in a real session, neither the old password nor the new password and its verification 
appear on the screen. 
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-<SYSTEM MESSAGES - “°° 
f A system message consists of the following parts: 

| * System message delimiter 

: ¢ Facility code 

! * Severity level code 

« Message identification code 


¢ Message text 


Figure 2-3: The Elements of a System Message ee ce 


SYSTEM Bu ce | : 
MESSAGE JS Bees 2o Hee, FEO Oe Be EP 
DELIMITER a . 


cry 
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FACILITY i: 
CODE .y. * ah 


SEVERITY 
LEVEL CODE 


MESSAGE 
IOENTIFICATION 
CODE 





%DCL-W-IVVERB, - unrecognized command verb - check spelling 
, \THINK\ 
ey aa ra 


MESSAGE TEXT MESSAGE TEXT 
TYTB_x0315_a8 
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Table 2—12:. Elements of the System Message 


Message 
Element Code Purpose 
System 3 %o | All system messages begin with either 
Message - a percent sign (%) or a hyphen (-). The 
Delimiter percent sign precedes the first system 
message received, while the hyphen 
precedes all additional messages. 
Facility DCL Names the portion of the operating 
Code TYPE system that detected an error. 
severity S svarteos dxerese.ae.: Describes the severity of the error. (For 
Level E eee ren an explanation of each severity level 
Code W wrananue: code, see Table 2-13.) | 
re 
Fo ora:eee’ - perac Cee. 
Message FNF Used to locate further information about 
Identification IVVERB a message. 
Code 
Message unrecognized Gives a more detailed explanation of 
Text command the error, and suggests an action to 
verb recover from the error. 
check 
spelling 
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Table 2-13: Severity Levels in System Error Messages 


Severity 

Level Abbreviation Comments 

Success S VMS does not usually display 
success messages. 

Informational | VMS sometimes displays ad- 
ditional information about suc— 
cess of operation. | 

Warning W Some operations may have suc— 
ceeded. Others may have failed. 

Error E The operation probably failed, 
but some part may have suc— 
ceeded. 

Severe (or F | The operation failed. 


Fatal) Error 
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* DISPLAYING CHARACTERISTICS OF TERMINAL, 
PROCESS, AND SYSTEM 


Your working environment is defined by the characteristics assigned to: — 
* Your terminal 
¢- Your process 


* Your system 
Terminal Characteristics 


e Physical (hardware) 

¢ Assigned by system manager 

¢ Displayed and changed with the following commands: 
—” SET TERMINAL 
— “SHOW TERMINAL 
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*THE SHOW TERMINAL COMMAND 


[ 


| 


{ 


| Example: 


The SHOW TERMINAL command displays the current characteristics of a terminal. Each char- 
acteristic corresponds to an option of the SET TERMINAL command. 


| $ SHOW TERMINAL 


Terminal: _VTA145: Device Type: PRO Series Owner: SMITH 
Physical terminal: LTA88: Username: SMITH 


: Input: 9600 LFfill: 0 Width: 80 Parity: None 
4 Output: 9600 CREiii:: 30 Page: 24 
i Terminal Characteristics: 
\ Interactive Echo Type ahead No Escape 
No Hostsyne TTsyne Lowercase Tab 
: Wrap Scope No Remote No Eightbit 
Broadcast No Readsyncec No Form Fulidup 
i No Modem No Local_echo No Autobaud Hangup 
No Brdcstmbx No DMA No Altypeahd Set_speed 
Line Editing Overstrike editing No Fallback No Dialup 
No Secure server Disconnect No Pasthru No Syspassword 
No SIXEL Graphics No Soft Characters Printer port Application keypad 
ANSI_CRT Regis No Block mode Advanced video 


\-Edit_mode DEC CRT No DEC CRT2 No DEC_CRT3 


<THE SET TERMINAL COMMAND 


The SET TERMINAL command changes the system's interpretation of the terminal’s character- 
istics. 


Example: 


$ SET TERMINAL/WIDTH=132 ~ Ae ow 


‘ This example changes the width of the terminal screen to 132 characters. 
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y Table 2-14: Commands for Displaying the Characteristics of Your Terminal, Process, and 


System 
VMS Command Command 
Information and Option Qualifier 
Time of Day $ SHOW TIME None 
Terminal Characteristics $ SHOW TERMINAL None 
“ Process Parameters 
Default Device te § SHOW PROCESS | None 
Default Directory $ SHOW PROCESS None 
User Name $ SHOW PROCESS None 
Priority $ SHOW PROCESS None 
Process Identification Code (PID) $ SHOW PROCESS None 
User Identification Code (UIC) $ SHOW PROCESS None 
Account Name $ SHOW PROCESS {QUOTAS 
Process Quotas and Limits $ SHOW PROCESS /QUOTAS 
Privileges $ SHOW PROCESS /PRIVILEGES 
space Available for Your Use on _— $s sHow quota None 
Your Default Device 
All Processes Running on Your Sys— = $ SHOW SYSTEM None 
tem 
Names of All Users Currently Logged ¢$ sHow usERS None 
in to Your System 
Names of Devices on Your System = $ SHOW DEVICES None 


: re, “ae TS 
a : ye f fo A teen at space ne + 
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SUMMARY 


To log in to the system: 

« Press <RET>. 

+ Type your user name <RET>. 

- Type your password <RET>. Remember, your password is not displayed. 
. To log out of the system: 


- Type LOGOUT <RET>. 


DCL Command Elements 


Command Element Definition 

Command line A command line is the complete specification of a DCL command. 

Required Elements of a Command Line | 

Verb The verb specifies the action of your request. 

Parameter Parameter(s) receives the action of the verb. 

Optional Elements of a Command Line | 

Qualifier The qualifier(s) describes or modifies the action taken by the verb. 
| A slash (/) precedes each qualifier. 

Value A value assigns a specific quantity to a qualifier. 

$ '. The dollar sign must precede commands you place in files. 


! The exclamation mark (!) indicates a comment. 


Label: The label ts a character string that identifies a particular line ina 
command procedure. 


Getting Help 


The documentation set contains information about the VMS system, discussions of concepts, 
and command definitions and examples. | 


The online Help facility is invoked by entering the HELP command. System Messages 


system messages consist of the system message delimiter, facility code, severity level code, 
message identification code and the message text. 
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MODULE 3 
CREATING AND EDITING TEXT FILES 


CREATING AND EDITING TEXT FILES 3—1 


INTRODUCTION 


One of the most common tasks for a user is the creation and modification of text files. Text files 
can assume a number of forms and can serve many purposes. They can be: 


* Memos and letters 
- Data files that are used by other programs and utilities 


¢ Computer programs written in a language like FORTRAN, Pascal, or COBOL 


VMS software provides a number of ways to create, maintain, and modify text files. The two 
most popular are: 


¢ The EDT Editor 


+ The Extensible VAX Editor (EVE) 


a 
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OBJECTIVES 


To create and modify text files on a VMS system, you should be able to: 


Use the proper DCL command to invoke a text editor. 
— EDT Editor 

— EVE Editor 

Identify the major features of each editor. 

Use appropriate commands and keys to perform editing tasks such as: 
— Moving the cursor 

— Adding and deleting text 

— Selecting and manipulating text strings 
Terminate an editing session. 

Use available online Help facilities. 


Recover files that were being edited at a system interruption. 


RESOURCES 


VMS Guide to Text Processing 
VMS Text Processing Utility Reference Manual (Appendix F) 
VMS EDT Reference Manual 
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CHOOSING AN EDITOR 


There are many reasons for choosing one editor over another. Your choice may be based on 


ease of editing, the ability to edit more than one file simultaneously, or using multiple buffers 
and windows. 


EDT is the editor supplied with many DIGITAL systems. The EVE editor is an editor available 
only on VMS systems. 


Restrictions may apply in unique situations, such as having to edit only on a hardcopy terminal. 


Features of both the EDT and EVE editors follow. This listing should aid you in deciding which 
editor to choose. 
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EDT Editing Utility 


Default text editing utility supplied with a VMS system 
Available on most DIGITAL systems 
Allows editing on hardcopy terminals —Not so w/EVE 
(15 Suky Bet Ss KEPT ARdds? ) 
More system load than EVE | 
Two editing modes are available 
— Line mode ~ DEF ROUT moh 
P= ARGYP AG MOUS = POUL cece 
Line mode 
— Automatically entered when EDT is invoked 
— Indicated by an asterisk prompt (*) 
-—- Works with the file on a line—by—line basis 
— Primarily intended for a hardcopy terminal 
Keypad mode 
— Requires a video terminal 
— Entered by using the CHANGE command at the line—mode prompt (*) 


— Works with the file as a unit 


— Modifications made on the screen become modifications to the file 
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The Extensible VAX Editor (EVE) 


Using EVE, it is possible to manipulate and edit text both in newly created files and existing files. 
* Features include: 

— Keypad editing 

— Insert and overstrike modes for text entry 

— Automatic word wrap 

— Multiple windows 


¢« Can be customized to the user’s needs, using the features of the VAXTPU programming 
language 


- Primarily a VMS editor 

¢ Less system load than EDT 

¢ Provides more features than EDT 

¢ Provides EDT-like keypad if desired 


¢ Functions on VT100 and VT200-—series and later terminals, and on VAX workstations 


EVE was designed with both ease of learning and ease of use in mind. Testing has shown it to 
be easier to learn and use than EDT. 


Each editor will be discussed in greater detail in the remainder of this module. 
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USING THE EDT EDITOR 


Invoking the EDT Editor 


wre aye 
t atte 
‘rane ** > 


- Command format: $ EDIT file-name VorAvee > °° 


nee 


¢ The command qualifier /EDT is available but not required 


EDT Screen Layout 


Figure 3-1: EDT Screen Layout — Line Mode and Keypad Mode 
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Using EDT Help 


- From Line mode 
— Type HELP at the asterisk (*) ys Topics are then listed 
— Type HELP topic-name 
— Enter CHANGE to switch to Keypad mode (if desired) 
@ From Keypad mode 
— Press <PF2> (VT100) or <HELP> (VT200) 


— Press key on which you want help 


— Press space bar to exit 
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Example 3-1: Using the Help Facility On Line 


S EDIT MYFILE.TXT 
1 Although the computer has always been 
*help 


HELP 
You can get help on a topic by typing: 
HELP topic subtopic subsubtopic... 
A topic can have one of the following forms: 


1. An alphanumeric string (e.g. a command name, option, etc.) 
2. The match-all or wildcard symbol (*) 


Examples: HELP SUBSTITUTE NEXT 
HELP CHANGE SUBCOMMAND 
HELP CH 


If a topic is abbreviated, HELP displays the text for all topics that 
match the abbreviation. 


Additional information available: 


CHANGE CLEAR COPY DEFINE DELETE EXIT FILL 
FIND HELP INCLUDE INSERT JOURNAL KEYPAD MOVE 
PRINT QUIT RANGE REP LACE RESEQUENCE SET SHOW 
SUBSTITUTE TAB TLE WRITE 


*HELP CHANGE 


The CHANGE command puts EDT in change mode. Use change mode to edit at 
the character level rather than the line level. 


Format: CHANGE [range] [;nokeypad command(s) ] 


The optional range specifies the cursor position when you enter change 
mode. If you omit range, the current position is used. 


There are three submodes of change mode. Which submode you use depends 
on the type of terminal you are using and whether or not you wish to use 
the auxiliary (numeric) keypad for editing commands. These modes are: 


1. Hardcopy mode 
2. Keypad mode 
3. Nokeypad mode 


If the CHANGE command contains a semicolon (;) it may be followed by 
nokeypad commands. If the last nokeypad command is EX, EDT returns to 
line mode for the next command line. This is the only form of the 
CHANGE command that may be used in a startup command file or macro. 
Additional information available: 


ENTITIES HARDCOPY KEYPAD NOKEYPAD SUBCOMMANDS 
xOUTT 
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The EDT Keypad 


Commonly Used Features 


- GOLD key (<PF1>) activates alternate definitions for keypad keys 
¢ Moving the cursor 

— By character, word, or line 

— To the top or bottom of files 

— In forward or reverse direction 
¢ Deleting and undeleting text 


— By character, word, or line 
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% Figure 3-2: EDT Keypad Definitions 
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Table 3-1: Moving the EDT Cursor 


Function Key 

Move one character in any direction Arrow keys (UP, DOWN, LEFT, RIGHT) 

Move to the beginning of the next line O (on keypad) 

Move to the beginning of the next word 1 (on keypad) 

Move to the end of the line 2 (on keypad) 

Move to the next section of the text (16 lines) 8 (on keypad) 

Move to the bottom of the buffer GOLD key (PF1) followed by 4 (on key- 
pad) 

Move to the top of the buffer na key (PF1) followed by 5 (on key- 
pad 


Table 3-2: Changing the EDT Cursor Direction 


Direction Key 
Set cursor to forward , 4 (on keypad) 
set cursor to backward 5 (on keypad) 
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Table 3-3: Deleting Text in EDT 


Function Key | Comments 
Delete characters <2X]}(VT200-series) Deletes the character.to the left of 
DELETE (VT100-series) the cursor ypc. 
*&  , (on keypad) Deletes the character on which-the 
cursor is pasitioned (uke on X) 
Delete words — (on keypad) Deletes characters from the cursor 
_ position to the beginning of the next 
word 
Delete lines PF4 Deletes text from the current cursor 
position to the beginning of the next 
line 


PF1 followed by 2 (on keypad) Deletes text between the cursor and 
the end of the line 


Table 3-4: Restoring Text in EDT 


Function Keypad Sequence 

Restore the last character deleted PF1 followed by comma (,) 
Restore the last word deleted PF1 followed by hyphen (-) 
Restore the last line deleted PF1 followed by PF4 ' 
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Ending an EDT Editing Session 


« From Keypad mode 
¢ Press <CTRL/Z> to return to Line mode 
- At the asterisk prompt 
— Enter EXIT to end the session and save changes, or 
— Enter QUIT to end the session without saving changes 
- Or 
- Press <PF1> then keypad key 7 - Re-Gwre wis Hope | 
¢ Atthe Command: prompt 
— Enter EXIT to end the session and save changes, or 


— Enter QUIT to end the session without saving changes 
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EDT File Recovery 


~*~ Journaling 

— Allows file recovery after a system interruption or failure _ 

— Used to reproduce the current editing session 

— Last few file modifications may not be recovered 
¢« Journal File 

— The default file name is the same as the input file name 

— The default file type is JOU 

— Contains keystrokes and editing commands of your current terminal session 
* Syntax 

$ EDIT/RECOVER file-name 


. Specify the original file type (not JOU) 


Example 3-2: Recovering a File After a System Interruption 


S$ EDIT MYFILE.TXT 

* CHANGE 

Editing session in progress. 
System interruption occurs. 
System recovers. 


$ EDIT/RECOVER MYFILE.TXT 
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USING EVE 


AO ANE ths 


Invoking the EVE Interface 


Command format: $ EDIT/TPU file-name 
EVE Screen Layout 


Figure 3-3: EVE Screen Layout 
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The EVE Interface 


Figure 3—4: EVE Keypad Definitions (VT100-Series Terminals) 
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Figure 3-5: EVE Keypad Definitions (VT200-Series Terminals) 
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MOVING THE EVE CURSOR 


The following table describes the editing keys and EVE commands that move the cursor. 


x Tabie 3-5: Moving the Cursor Using Keys 


Key 

UP ARROW 
DOWN ARROW 
LEFT ARROW 
RIGHT ARROW 
CTRL/E 
CTRL/H 

MOVE BY LINE 


PREV SCREEN 
NEXT SCREEN 


Cursor Destination 


Moves the cursor up one character. 

Moves the cursor down one character. 

Moves the cursor one character to the left. 

Moves the cursor one character to the right. 

Moves the cursor to the end of the current line. 
Moves the cursor to the beginning of the current line. 


Moves the cursor to the end of the current line or to the end 
of the next line if the cursor is already at the end of a line, 
when the current direction is forward. Moves the cursor to the 
beginning of the current line or to the beginning of the previous 
line if the cursor is already at the beginning of a line, when the 
current direction is reverse. 


Moves the cursor to the previous screen of the current buffer. 
Moves the cursor to the next screen of the current buffer. 
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‘|. Table 3-6: Using Commands to Move the Cursor 


sy 
roti 
a 


Command 


Cursor Destination 





TOP 
BOTTOM 
BUFFER <2 2geere7 


“ GET FILE 


[file-name] 


LINE 
MOVE BY WORD 
TWO OWING ey 


OTHER WINDOW 


Com*a tr Wee Gem ines od 


Moves the cursor to the beginning of the current buffer. 
Moves the cursor to the end of the current buffer. 


Puts the specified buffer in the current window, and moves the 
cursor to the last location it occupied in that buffer. Creates a 
new buffer if the specified buffer does not exist. 


Creates a new buffer that contains the text of the specified file, 
places the new buffer in the current window with the cursor at 
the beginning of the new buffer. If you specify a nonexistant 
file, an empty buffer is created. 


Moves the cursor to the beginning of line n in the current buffer. 
n must be a positive integer. 


Moves the cursor to the beginning of the next word when the 
current direction is forward. Moves the cursor to the beginning 
of the previous mword ® when the current direction is reverse. 
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INSERTING TEXT IN EVE 


The <INSERT OVERSTR=> key changes the current editing mode. The editing mode is displayed 
in the status line. 


Text is inserted at the current cursor position when in /nsert mode, while text already in the file 
moves to the right. 


Text already in the file is overwritten when in Overstrike mode at the current cursor position. 


ERASING TEXT 


Table 3—7 shows the editing keys used to erase text. 


Ye Table 3-7: Keys for Deleting Text 


i 


Key Effect - 

DELETE <X| Deletes the character to the left of the cursor. 

ERASE WORD Deletes the current word or, if the cursor is not on a word, 
deletes the next word. | 

CTRL/U ‘Deletes all characters from the current cursor position to the 
beginning of the line. 

SELECT | Marks text for removal from the initial cursor position to wherever 
you move the cursor. 

REMOVE Removes the text that was marked by the SELECT key. 

INSERT HERE Inserts the text in the INSERT HERE buffer into the file at the 


current cursor position. 
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* DEFINING AN EDT-LIKE KEYPAD 


The command SET KEYPAD EDT defines an EDT-like keyboard. Note that this command does 
not enable you to. enter EDT commands by using the <DO> key. You only have access to the 


EDT—like functions by pressing the keypad keys. 
The EDT-style keypad does not fully implement EDT. The differences are: 


° Soe makes EVE write the buffer to a file and exit to the DCL prompt. 
a an 


: <GOLDIKP7> | is defined as the <DO> key when the keypad is set to EDT. 
wok etre te 4 


%* <GOLD/KP8> is defined as <FILL>, to reformat the currently selected text or the current 


paragraph. lf you want this key to fill only the selected text (as in real EDT) redefine the 
key as <FILL RANGE>. 


¢ EVE defines the <ENTER> key as <RET>. 


USANGELING AN EDT-—LIKE KEYPAD 


- i tetled t 


The sansa SET KEYPAD NOEDT cancels the EDT-like keypad setting. 
For VT100—series terminals, this command sets the keypad to VT100, which is the default setting. 


For VT200-series terminals, this command sets the keypad to NUMERIC, which is the default 
setting. 
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Figure 3-6: EDT-Like Key Definitions for VT200—Series Terminals (Cont) 
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Figure 3-7: EDT-Like Key Definitions for VT100~—Series Terminals 
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Figure 3-7: EDT-—Like Key Definitions for VT100-—Series Terminals (Cont) 
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Using EVE Help 


e Line mode 
— Press <DO> (VT200) or <PF4> (VT100) 
— Type HELP 
— Enter the topic for which you want help 
— Press <RET> to exit help 

¢ Keypad mode 
— Press <PF2> (VT100) or <HELP> (VT200) 
— Press key on which you want help 


— Press <RET> to exit 
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Ending an EVE Session 


. Press <CTRL/Z> to exit and save modifications 
¢ Press <DO> (VT200) or <PF4> (VT100) 
— Type EXIT at command prompt to save modifications, or 


— Type QUIT at command prompt to disregard modifications 
EVE File Recovery 


¢ Journaling facility is identical to EDT 
— Allows file recovery after a system interruption 
— Used to reproduce the editing session 
— Last few changes are not recovered 
e Journal file 
— The default file name is the same as the input file name 
— Contains keystrokes and editing commands of your current terminal session 
¢ Command syntax: 
a $ EDITIT PUIRECOVER tile-name | 
° ‘saan’ the Original file type (not TUL) 


¢« Example: 


$ EDIT/TPU/RECOVER MYFILE.TEXT 
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SUMMARY 


There are two editors available on a VMS system: EDT (the default editor) and EVE. 
Two editing modes are available with EDT: 


° Line mode 


+ Keypad mode 


EVE features include: 

+ Keypad editing 

* Insert and Overstrike modes for text entry 
¢« Automatic word wrap 


¢ Multiple windows 


The EDT Editor is invoked by: 

$ EDIT file-name 

The EVE Editor is invoked by: 

$ EDIT/TPU file-name 

HELP is available within both editors. 


An EDT editing session is ended by pressing <CTRL/Z> then entering EXIT or QUIT, or by 
pressing <PF1> then keypad key 7 and entering EXIT or QUIT. 


An EVE editing session is ended by pressing <CTRL/Z> or by pressing either <DO> or <PF4> 
then entering EXIT or QUIT. 
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APPENDIX A—EDT LINE-MODE EDITING 


EDT’s line editing facility can be used with any interactive terminal. Line editing uses the line as 
its point of reference. Line editing commands are useful for manipulating large blocks of text. 


To aid in locating and editing text, EDT assigns line numbers. These line numbers are not part 
of the text and are not kept in the file when you finish an editing session. 


The following commands deal with line—mode editing. 


Inserting Text 


Use the INSERT command to insert text. The cursor indents 16 spaces and waits for the text 
to be inserted. You can enter as many lines as you wish. 


Example: 
$ EDIT INSERT.FYI 
1 This is line l 
* 
2 This is line 2 
* 
3 This is line 3 
° ) 
4 etc. 
* 
[EOB] 
*INSERT...2. 


This is the new text which is being typed 
in the file. It is being inserted prior to 


iine..2. 

*EXIT 

S$ EDIT INSERT.FYI 

1 This is line 1 

* 

Z This is the new text which is being typed 
*« 

3 in the file. It is being inserted prior to 
* 

4 ‘Line 2 

* 

a This is line 2 

* 

6 This is line 3 

* 

7 etc. 

* 

(EOB] 

*QUIT 
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Substituting Text 
Use either the SUBSTITUTE or SUBSTITUTE NEXT command to substitute strings of text. 


The SUBSTITUTE command operates on the current line or on a specified range within the 
buffer. 


syntax: 
*SUBSTITUTE/old-string/new-string 


Example: 


* SUBSTITUTE /FORTRAN/PASCAL 


To substitute a string throughout the complete buffer, use the WHOLE parameter in conjunction 
with the SUBSTITUTE command: 


Example: 


* SUBSTITUTE/FORTRAN/PASCAL/WHOLE 


The SUBSTITUTE NEXT command operates on the next occurrence of the specified string 
within the buffer. 


— Syntax: 
*SUBSTITUTE NEXT/old-string/new-string 


Example: 


*SUBSTITUTE NEXT/FORTRAN/PASCAL 


3- 32 CREATING AND EDITING TEXT FILES 


Moving Text from One Location to Another 


Use either the MOVE or COPY command to move one or more lines of text from one location 
to another. 


Note that the MOVE command deletes the text from the original location, whereas the COPY 
command does not delete the text. 


Syntax: 
*MOVE first-range TO second-range 


In the following example, lines 20 through 30 are moved above line 10. Note that "second-range" 
always refers to a single line. 


*MOVE 20 THRU 30 TO 10 Aan alme Ose 
To move the current line, enter: 

*MOVE TO 15 
To move text without deleting the text in the original position, use the COPY command. 
Syntax: 
*COPY first-range TO second-—range 


In the following example, lines 35 through 43 are moved above line 7. 


*COPY 35: THRU 43 ‘TO°7 
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Deleting Text 


The DELETE command deletes lines or group of lines. 


syntax: 
*DELETE range 


The following example shows how to delete line 2 in a file. 


S$ EDIT MYFILE.TXT 


1 This is 
* TYPE WHOLE 

2 This is 

3 This is 

4 This is 
* DELETE 2 


Line 


line 
Line 
Line 


1 line deleted 


3 This is 
* TYPE WHOLE 
1 This is 
3 Lats: 2s 
4 This is 


Line 


Line 
Line 
Line 


One of EDT’s features 
understand the relationship between buffers and files. 


a 
s 
4 


is the ability to edit more than one file. To accomplish this, you must 


The following section describes the use of buffers in EDT. 
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¥ Using Buffers in EDT 


Buffers are temporary storage areas for text. Buffers enable you to: 
¢ Divide one or more files into sections. 
¢ Move part or all of another file into your editing session. sy ke 


- Create a file from part or all of the text in a buffer. a ee 


When an editing session has started, a buffer called MAIN is automatically provided by EDT. 


OE et 4 ee TE 


The MAIN buffer serves as the work area for you. 


How to Create Buffers 


e Press the <GOLD> key, followed by the COMMAND function. 
¢ At the Command: prompt, enter 
— The FIND command 
— An equal sign (=) 
— Buffer name of your choice (buffer names must begin with a letter) 


Example: 


Command: FIND=PASCAL 


. 4 
4 4S 4 
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You can now insert and edit text in the MAIN buffer. 





To return to the MAIN buffer, enter: 


Command: FIND=MAIN 
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The COPY command is used to copy the contents of one buffer into another buffer. In the 


following example, the contents of the buffer MAIN are copied into the buffer FORTRAN. The 
current buffer becomes FORTRAN. 


*COPY =MAIN TO =FORTRAN 


* Copying Text from a File into a Buffer 


The INCLUDE command copies a file (outside of EDT) into a buffer. In this example, a file 
named MYFILE.TXT is copied into the MAIN buffer. 


*INCLUDE MYFILE.TXT =MAIN 


* Copying Text from a Buffer into a File 


The WRITE command copies text from your current editing session into a file of your choice. In 
this example, the entire contents of the current buffer are written to a file named MYFILE.FOR. 


*WRITE MYFILE.FOR 


+ Deleting Buffers 


Use the line-mode command CLEAR to delete buffers during an editing session. In the following 
example, the buffer PASCAL is deleted. 


*CLEAR PASCAL 
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APPENDIX B—EVE 


The following EVE commands are discussed in addition to the commands included in the previ 
ous EVE section of the module. 


Inserting Text 
You can insert: 


¢ Text - Characters will be inserted into the buffer at the current cursor position by typing in 
the text. 


ee Files - Files can be inserted using the INCLUDE FILE command. The contents of the 
specified file are inserted into the buffer at the line before the current cursor location. 


syntax: 
> INCLUDE FILE [file-name] | 


* Special Nonprinting Characters - Press <CTRL/V> and then press the special nonprinting 
character. 


Example of inserting a form feed into the buffer: 
Ye Press <CTRL/V> 
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Locating Text 
syntax: 
¥ FIND search-string 
The <FIND> key is used to locate specified text strings. 


lf the search string is in lowercase characters, EVE disregards the case of letters and locates 
any occurrence of the string. 


If the search string contains one or more uppercase letters, EVE locates only the occurrences 
of the string that match the search string exactly. 


lf a search string is found, EVE displays the string in highlighted type. EVE also defines the 


search string as a select range. While the search string is highlighted, you can perform any 
operation on it that requires a select range. 


* Marking Locations in Text 


The MARK and GO TO commands are used when you are editing a large file and wish to return 
to a specific location later on during an editing session. 


Press <DO> and enter MARK label-name. The label name can be one or more alphanumeric 
characters. 


Press <DO> and enter GO TO label—name to move the cursor to the marked location. 
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* Replacing Text 


The REPLACE command allows you to replace a text string in the current buffer-with another 


text string. 


Format: 


. Press <DO> 


- EnterREPLACE {.%2 © 60 fore) Mice 


- Enter the string to be replaced following the "Old string" prompt 


* enter the new string at the "New string” prompt 


EVE moves the cursor to the first occurrence of the string, and prompts: Replace? Type 
yes,no,all,last or quit. The following table lists the response and the action by EVE. 


Table 3-8: Responding to REPLACE Prompts 


Response 
YES 


NO 
ALL 
LAST 


QUIT 


EVE’s Action 


Replaces the string and attempts to locate another occurrence of the string in 
the current direction. 


Does not replace the string, and attempts to locate another occurrence of the 
string in the current direction. 


Replaces the string and all other occurrences of the string in the current direc— 
tion. The cursor is moved to the position where the last replacement occurred. 


Replaces this occurrence of the string and stops the REPLACE procedure. 
The cursor does not move. 


Does not replace this occurrence of the string and stops the REPLACE pro- 
cedure. The cursor does not move. 
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<< Restoring Text 


The RESTORE command restores (or undeletes) the last word, sentence, or line erased by any 
of the following: 


e Any EVE command or any key bound to an EVE command 
« The <DEL> key 


¢ Also includes the <PF4>, <MINUS>, <KP6>, <COMMA>, and <KP2> keys when the keypad 
is set to EDT 


RESTORE CHARACTER 


The RESTORE CHARACTER command restores (or undeletes) the character last erased by 
any of the following: 


¢ The ERASE CHARACTER command or any key bound to that command 
- The <DEL> key 


¢ Also includes the <COMMA> key when the keypad is set to EDT 


RESTORE LINE 


The RESTORE LINE command restores (or undeletes) the line last erased by any of the follow— 
ing: 


e The EVE commands ERASE LINE, ERASE START OF LINE, or any key bound to these 
commands 


¢ The <GOLD/DEL> key sequence on a VT200 terminal 


¢ Also includes the <PF4> or <GOLD/KP2> keys when the keypad is set to EDT 


RESTORE WORD 


The RESTORE WORD command restores (or undeletes) the word last erased by any of the 
following: 


¢ The ERASE WORD command or any key bound to that command 


¢ Also includes the <MINUS> key when the keypad is set to EDT 


3-40 CREATING AND EDITING TEXT FILES 


* Using Buffers in EVE 


Buffers are used during an editing session as storage areas. The following table describes the 
commands that are used to create and manipulate buffers. 


Table 3-9: Creating and Manipulating Buffers 


Command 


Function 





BUFFER 


GET FILE 


SHOW 


WRITE FILE 


Puts the specified buffer in the current window and moves the 
cursor to the last location it occupied in that buffer. Creates a 
new buffer if the specified buffer does not exist. 


Creates a new buffer containing the text of the specified file, 
places the new buffer in the current window, and places the 
cursor at the beginning of the new buffer. If a file is specified 
that does not exist, an empty buffer is created. 


Displays a screen of information about the current buffer. If 
more than one buffer is active in the editing session, press the 
DO key to display information about the other buffers. 


Writes the contents of the current buffer to a file. If a file name 
is not specified, EVE uses the buffer name as the file name. 
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Using Multipie Buffers 


Use multiple buffers when you want to edit more than one file. This is very useful if you want to 
move text from one file to another file. - 


To create a new buffer 
° Press <DO> 


¢ Enter GET FILE file~-name 


To change the buffer in the current window 
« Press <DO> 


« Enter BUFFER buffer-name 


When you exit from using multiple buffers, EVE writes the contents of the current buffer to a file 
and asks if you want to write the other buffer to a file. 
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%* Using Multiple Windows 


EVE allows you to view multiple windows on your terminal screen at the same time. You can 
view and edit either two sections of the same buffer (one file) or multiple buffers (multiple files) 


simultaneously. 


The following table lists commands that are used to create and manipulate windows. 


Table 3-10: Creating and Manipulating Windows 


Command 
TWO WINDOWS 


OTHER WINDOW 


ONE WINDOW 


GET FILE 


BUFFER 


Function 


Splits the terminal screen and creates two editing windows, 
moving the cursor to the last position it occupied in the text 
of the bottom window. 


Moves the cursor to the last position it occupied in the other 
window. | 


Removes the other window from the screen, expanding the cur-— 


rent window to occupy the complete screen. 


Creates a new buffer containing the text of the specified file, 
places the new buffer in the current window, and places the 
cursor at the beginning of the new buffer. If a nonexistant file 
is specified, an empty buffer is created. After you create two 
windows on your terminal screen, use the GET FILE command 
to create a new buffer in one of the windows. 


Puts a new buffer in the current window, and moves the cursor 
to the last position it occupied in the buffer. Creates a new 
buffer if the specified buffer does not exist. After you create two 
windows on your terminal screen, use the BUFFER command 
to put a different buffer in one of the windows. 
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DELETE WINDOW 
The DELETE WINDOW command deletes the window in which the cursor is located, if you are 


using more than one window. Be aware that any edits or modifications made to the file in the 
current window will not be saved. 


ENLARGE WINDOW 
syntax: 
ENLARGE WINDOW integer 


This command enlarges the window in which the cursor is located by the number of lines spec-— 
ified. EVE shrinks the other windows on the screen accordingly. 


Integer is the number of lines you want to add to the current window. The minimum value is 1. 
The maximum value is 20 for a VT100 or VT200 screen. 


NEXT WINDOW 


The NEXT WINDOW command moves the cursor from the current window to the window below. 
lf the cursor is already in the bottom window, EVE moves the cursor to the top window. 


PREVIOUS WINDOW 


The PREVIOUS WINDOW command moves the cursor from the current window to the window 
above. If the cursor is already in the top window, EVE moves the cursor to the bottom window. 
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SHRINK WINDOW 
syntax: 
SHRINK WINDOW integer 


The SHRINK WINDOW command reduces the size of the window the cursor is currently in by 
the number of lines specified. EVE enlarges the other windows accordingly. 


Integer is the number of lines by which you want to shrink the window. The minimum value is 
1. The maximum value is 9, which is the number of lines by which you can shrink a window if 
you have only two windows on the screen. 


SPLIT WINDOW 

Syntax: 

SPLIT WINDOW integer 

The SPLIT WINDOW command splits the window in which the cursor is located. 


Integer is the number of smaller windows that you want to appear on the terminal screen. If 
you omit the integer, the current window is replaced with two windows. 
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DEFINING KEYS 


You can define keys to execute frequently used EVE commands. 


definitions to be used from one editing session to the next. 
EVE does not allow you to define 

¢ The <DO> key --~ 

- The <RET> key. 

* The space bar -~” 


- All printing characters on the main keyboard ~~ 


You may also save key 


DIGITAL recommends that you do not define the following keys and control key sequences 


e <DELETE> 
¢ <F6> (VT200 series) 


e <HELP> (VT200 series) <PF2> (VT100 series) 


© <CTRUC> 
e <CTRL/R> 
* <CTRL/S> 
¢ <CTRL/T> 
e <CTRL/U> 
© <CTRL/Q> 
¢  <CTRL/X> 
e <CTRL/Y> 


To define a key | 


¢ Press <DO> 


- Enter DEFINE KEY 


- Type the key to be associated with the EVE command 


> Amessage, Key defined, appears if you have successfully defined a key 
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* Saving Key Definitions 


The SAVE. EXTENDED TPU command saves all key definitions in a section file that you specify. 
This command must be executed before ending an editing session. 


Format: 


Pa A ae wet 
nes | ae ae 


“~ SAVE EXTENDED TPU device:[directory]file-name.TPUSSECTION | 


You should include the device, directory, and file name that you choose. The section must be 
TPUSSECTION. 


lf you specify the same file name each time you execute the SAVE EXTENDED TPU command, 
all key definitions will accumulate in the same file from all editing sessions. 


¥*Using Key Definitions 


To use this extended version of EVE, you must include the /SECTION qualifier when invoking 
EVE. 


Syntax: 
&EDIT/T PU/SECTION=device:[directory]file-name.TPUSSECTION file-name 


Example: 


§ EDIT/TPU/SECTION=DISK: [SMITH] EVEDEFS. TPUSSECTION MYFILE.TXT 


* Checking Spelling Errors 


The SPELL command checks for spelling errors in a selected text or buffer if your system 
contains VAX-11 DECSpell. 


If you do not select any text, SPELL checks the entire current buffer, and replaces the misspelled 
words with correct words. 


BS awe 


WE Bday PRE. 
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MODULE 4 
COMMUNICATING WITH OTHER USERS 


COMMUNICATING WITH OTHER USERS 4-1 





INTRODUCTION 


The ability to communicate with users, both on your system and on other VMS systems is 
invaluable. There are two VMS utilities and a DCL command that allow you to do this. They 
are: 


¢« The Mail utility (MAIL), which allows you to send and receive messages to other users. 


ea ¢« The Phone utility (PHONE) for communicating interactively with other users that are logged 
in. j 


4 The DCL command REQUEST, which displays a message sent by you at a system opera— 
tor’s terminal, and optionally, requests a reply. 


OBJECTIVES 


To effectively communicate with other users, you should-be able to: 
« Send and receive messages between users. 
e Print and delete mail messages. 
* »* Organize mail messages by using mail files. 
¢ Place and answer calls using the Phone utility. 


** Send messages to a system operator using the REQUEST command. 
RESOURCES 


¢ VMS Mail Utility Manual 
¢ VMS Phone Utility Manual 
¢ VMS DCL Dictionary 
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INVOKING AND OBTAINING HELP FROM THE MAIL 
AND PHONE UTILITIES 


¢« Enter the command that invokes the utility © 
— The name of the utility (MAIL or PHONE) 


— The screen prompt is the name of the utility (MAIL> or PHONE>) 
\ (ae eh 


onea y oie u VAT $. vee 2 ‘ 
* Enter the HELP command at the utility's prompt NUT REALLY , PAU) 


MAIL> HELP 
¢ Follow the online HELP instructions 
¢ To exit the utility, enter 

— The EXIT command at the utility’s prompt, or 


— The <CTRL/Z> key sequence, which brings the utility's prompt to the screen, followed 
by another <CTRL/Z> key sequence 
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Example 4-1: Getting Help for MAIL Utility Commands 


MAIL> HELP 
HELP 
Allows you to obtain information about the MAIL Utility. 


To obtain information about all of the MAIL commands, enter the 
following command: 


MAIL> HELP * 


To obtain information about individual commands or topics, enter 
HELP followed by the command or topic name. 


Format: 
HELP [topic] 


Additional information available: 


/EDIT /PERSONAL_NAME / SELF /SUBJECT ANSWER ATTACH 
BACK COMPRESS COPY CURRENT DEFINE DELETE DIRECTORY 
EDIT ERASE EXIT EXTRACT FILE FIRST Folders. 
FORWARD GETTING STARTED HELP KEYPAD LAST MAIL 
MARK MOVE NEXT PRINT PURGE QUIT READ 
REMOVE REPLY SEARCH SELECT SEND SET-SHOW SPAWN 

V5_ CHANGES 


Topic? READ 
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THE MAIL UTILITY 


Allows you to send messages to and receive messages from other users, both on your 
system or within a network. 


Organization of Mail Messages 


4 
‘4 
ee eel peer Tah ye CEES ENE 


By defauit, a file named MAIL.MAI stores mail messages. This file is automatically created 
for you by the system. 


MAIL organizes messages in folders. Three of these folders are named: 

— NEWMAIL — Contains new messages you have not yet read. 

— MAIL - Contains old messages you have already looked at. 

— WASTEBASKET — Contains messages marked for deletion. Wicn Vere a te 


The Wastebasket folder is emptied automatically when you exit from MAIL. 
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Using the MAIL Utility 


> Use the MAIL command to invoke the utility 


S$ MAIL<RET> 
MATL> 


- Enter MAIL commands to 
— Read messages you have received 
— Send messages to other users | 
— Obtain a list of mail messages you have received 
-—- Delete old mail messages 


— Learn about other MAIL commands 
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¥Reading a Message 
When you log in to the system, you are notified of any new mail messages. 


lf you are currently logged in, the Mail utility displays an informational message on your terminal 
screen. 


¢ To read the first new message 
— |nvoke the Mail utility 
— Press <RET> at the MA/L> prompt 


# ° To read a message you receive while usin 


ARATE OR ERAT 


g.the Mail utility 
— Enter the READ/NEW command 


MAIL> READ /NEW 
¢ The folder you are currently in is displayed in the upper right-hand corner of the screen 


Example 4-2: Reading a Mail Message 


$ MAIL 


You have 1 new message. 


MAIL> | 

#1 «12 =DEC-1984 09:19:25 NEWMAIL 
From: SPEEDY: :JIM 

To: SMITH 

Subj: Status meeting 

John, 


I will be out of town so I will not be able to attend the status 
meeting. Fill me in when I get back. 


Jim 


MATL> 
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|. Table 4-1: MAIL Commands Used to Read a Mail Message 





Operation Format/Example 


Displaying the contents of a READ n 
message in the current folder 
of the current file — 


READ<RET> 
READ/NEW 


NEXT 


FIRST 
LAST 
CURRENT 


BACK 


Comment 


Displays the message associated with 
the message number (n) 


Displays the next page of the current 
message having the next—highest mes— 
sage number 


Displays new messages that arrived 
while you are in MAIL, 


Displays the first page of the mes-— 
sage having the next—highest message 
number 


Displays the contents of the message 
having the lowest message number 


Displays the contents of the message 
having the highest message number 


Displays the contents of the current 
(last-read) message 


Displays the contents of the message 
preceding the current message 
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sending a Message 


« Using the SEND command 
— At the MAIL> prompt, enter the SEND command 
— Enter the node (if different from your node) and user name 
— Enter the subject of the message 
— Enter the message 


Press <RET> at the end of each line 
Press <CTRL/Z> after the last line 
Press <CTRL/C> to cancel the message 


Example 4—3: Sending a Mail Message 


$ MAIL 

MAIL> SEND 

io7 SMITH 

Subj: Department Meeting 


Enter your message below. Press CTRL/Z when complete, or CTRL/C to quit: 
Jim, 


There will be a department meeting on Friday at 9:00 am. 
Please attend if at all possible. 

John © 

CTRL/Z 

MAIL> 
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Ye Table 4-2: MAIL Commands Used to Send Messages 


Operation — Format/Example Comment 





Routing a message or the MAIL> SEND [/qualifier] [file-specification] 
contents of a file to a user 
or group of users 


MAIL> SEND | Routes the contents of your mes— 
4 To: JONES,ALAN sage to each user listed after 
Subj: Today’s Agenda | the To: prompt. 
MAIL> SEND/EDIT Routes the contents of your mes— 
\ aK To: @DISTRIBUTION.DIS sage to each user listed in the 
Subj: Today’s Agenda file named DISTRIBUTION.DIS... 


You enter the message by us- 
ing the EDT editor. The mes- 
sage is sent when you exit the 


editor. | 
_ / MAIL> SEND MYFILE.LIS Routes the contents of the file 
“{ To: JONES _ MYFILE.LIS to the mail file of 
\ Subj: Today’s Agenda the user JONES. 
Routing a copy of the cur—- * MAIL> FORWARD Routes a copy of the current 
rent (last-read) message toa | To: JONES message to each user listed af- 
user or group of users \Subj: Good News! ter the Jo: prompt. 


Routing a message or the’* ANSWER or 

contents of a file tothe sender REPLY [/qualifier] [file-specification] | 
of t h ecu rr e nt (| a st— r e 2 d) m es— Ee eS a SE eee SN MEETOSSEETT Son Sohne Ron oe a acs 
sage 


_” MAIL> REPLY x The REPLY or REPLY/EDIT com- 
| Subj: You’re Right! mand routes your message to 
7 the sender of the current mes- 
sage. (REPLY and ANSWER 
are synonyms.) 
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** Displaying a List of Messages 


- The DIRECTORY command displays a numbered list of your mail messages. 


MAIL> DIRECTORY 


¢ To read an old message 


— Enter the DIRECTORY. command 


— Enter the desired message number 


Example 4—4: Listing Messages and Reading Old Messages 


MATL> DIRECTORY 


# From Date Subject | MAIL 
1 SPEEDY: :JIM 12-DEC-1984 Status meeting 
2 SPEEDY: :SMITH 12-DEC-1984 Schedule of meetings 
3 SPEEDY: : JONES 12-DEC-1984 Party 
MAIL> 3 
+3 12-DEC-1984 09:22:53 MAIL 
From: SPEEDY: : JONES 
oe SMITH 
Subj: Party 
John, 


We’re having an office party next Thursday. 
Would you like to come? 


Tom 


MATL> 
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Deleting a Message 


Ee 
i 


The DELETE command moves a messacge to the Wastebasket folder. The message is not 
deleted until you exit Mail. 


Either a single message or a range of messages can be deleted. 


lf a message number is omitted, this command marks the message you are currently reading 
for deletion. 


MAIL> DELETE 3 (Deletes message number 3) 
MAIL> DELETE 1,3,5-7 (Deletes message numbers 1, 3, 5, 6, 7) 


Deleted messages.may be recovered. from.the..Wastebasket folder. by..using the MOVE 
command. 


ataon A PEEL PAE S, 
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Figure 4—1: The Relationship Between a Mail Message, Folder, and File 





TTB_X0325_88 


COMMUNICATING WITH OTHER USERS 4-15 


f Table 4-3: MAIL Commands Used to Maintain Messages 


Operation Example 


Displaying a list of folders 


PETITE EEE NR 
a IE 
ng ES 


, Displaying a list of messages 


DIRECTORY CALENDAR 


& 
3 


‘Moving between folders SELECT CALENDAR 





a , Filing a message MOVE CALENDAR 
Copying a message to a file =xTRACT DWAYNE.TXT 
_ Printing a message PRINT 


Emptying the Wastebasket 
folder 


PURGE or EXIT 


oF Sanayi 
eer ? 2 ite c 
4 OLE f 


° ns ; : sN yuo 
+” ¥ na : : smelt 
ee ee ie ei an 





aes - : . oe : 7 eee as nh el gas oR 
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a . 8 Bebe be oS 7 uf wet dN _ : Ts ro i : 
GaN RF: BE ge Reet 28 : : ae ] : 
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DIRECTORY AFOLDERMAME > 


Comments 





Displays a list of all folders in 
the current mail file. 


Produces a list of all the mes— 
sages in the folder. Each mes- 
sage contains a message num- 
ber. 


Moves you between folders of 
your choice. 


Moves the current message to 
the folder named CALENDAR. 


Places a copy of the current 
message into a sequential file 
with the file name specified. 


Places a copy of the current 
message into the default queue 
for printing. 


Discards all messages in the 
Wastebasket folder. 


E ; 

FS eet OS eal % % a ord wenger t 

oh ae a a ey Ene fF 

Te FO we |) CTR Po * 
é : 


Exiting from the Mail Utility 


. Enter the EXIT command, or 


¢ Press <CTRL/Z> at the MA/L> prompt 
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THE PHONE UTILITY 


You can use the Phone utility to contact another user by: 


* Entering the name of a user as a parameter to the PHONE command. 


$ PHONE HARKINS 


¢ Entering the name of a user from within the Phone utility. 


S$ PHONE 
% DIAL HARKINS 


The system responds to your request by displaying a repeating message on the terminal of user 
HARKINS. To respond to this message, HARKINS must: 


¢ Enter the PHONE command, then 
« Enter the ANSWER command, or 


- Enter the REJECT command at the % prompt 


To enter a command while having a conversation, type the percent sign (%) followed by the 
command. 


¥ 
YP em sin ge Pad 
ae \ erie ere ’ . BS 
C 4 owe “wx, om 4, e ; : ate mo t : ‘ (pel tage 6 
ot Chane Oe © are nT Se ae go! at wee 
AN OA LEM LPS £4 Pe ee a ee a A is 
‘ ‘waa Se" weit Lee wach eo $ en: # 4 


‘y 

aa ee eee . fn gt oer WP cise nr ci ‘ 

C CAY ye De plat ae Ge OF “SE AIDE é 
; ee fe a oh. Ee 
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The Phone Help Facility 


¢ To display a list of available help topics, enter the HELP command. — 
* To display a particular help text, enter the command HELP help-option. 
- After you receive the help display, type any character to refresh the Phone split screen. 


* Entering either the EXIT command or pressing <CTRL/Z> returns you to DCL command 
level. (Remember, to enter the EXIT command during a conversation, you must first type a 
percent sign.) 


Figure 4—2: Using the Phone Utility 
VMS PHONE FACILITY 10-FEB-84 
% your phone commands: 


SUPER::SMITH 


your message 


SUPER::HARKINS 


their message 
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\.- Table 44: Phone Commands Commonly Used to Create or Reject a Terminal Link 


»*, 
twas wee 


Operation Format/Example Comment 


Choosing who to call DIRECTORY [node[::]] Displays a list of people with 
whom you could talk on your 
system or any other system in 


the network. 
Requesting a terminal link DIAL user—name Displays a repeating message 
| DIAL JONES on the terminal JONES is logged 
in to, that signifies a terminal 
link request. | 
Accepting a terminal link ANSWER Links your terminal to the ter- 


minal of the caller. The split 
screen is displayed. 


Rejecting a terminal link REJECT Terminates the repeating mes— 
| sage caused by the DIAL com- 
mand entered by another user. 


Placing others on hold HOLD Places all other terminals in the 
conversation on HOLD. 


Reversing the hold UNHOLD Reverses your previously en- 
tered HOLD command. 
Terminating a terminal link HANGUP | Terminates the links of all ter— 
minals in the conversation. 
Leaving the Phone utility EXIT — Exits the Phone utility by first 
<CTRL/Z> executing an automatic HANGUP 
command. 
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COMMUNICATING WITH OPERATORS 


~The REQUEST Command 


There may be times when you wish to communicate with a system operator. For example, you 
may need to have a magnetic tape mounted so you can access it. 


The REQUEST command displays a message at a system operator's terminal and optionally 
requests a reply. 


* Sending a message without a reply 
$ REQUEST "message-text” 
_ § REQUEST "Please mount magtape 4 on MTAO:" 
« Sending a message that expects an operator reply 
$ REQUEST/REPLY "message—text" 


$ REQUEST/REPLY "Please mount magtape 4 on MTAO" 


Example 4—5: Using the REQUEST/REPLY Command 


$ REQUEST/REPLY "Please mount magtape 4 on MTAO" 
%SOPCOM-S~-OPRNOTIF, operator notified waiting... 11:23:02.92 
SOPCOM-S-OPREPLY, AFTER 11:30 

13-MAR-1985 11:26:03.87, request 7 completed by operator OPAO 
S 
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SUMMARY 


The Mail Utility 


The Mail utility allows you to send to and receive mesages from other users, both on your system 
and within a network. The Mail utility is invoked by entering MAIL at the DCL prompt. 


¢ To read a new message, press <RET> at the MA/L> prompt. 
- To read a message received while you are in the Mail utility, enter the READ/NEW command. 
- To send a message, enter the SEND command at the MAI/L> prompt. 

— Enter the node (if different from your node) and user name 

— Enter the subject of the message | 

— Enter the message 


— Press <CTRL/Z> after the last line of the message 


The Phone Utility 
You can use the Phone utility to contact another user by: 
¢ Entering the name of a user as a parameter to the PHONE command. 


- Entering the name of a user from within the Phone utility. 


To enter a command while having a conversation, type the percent sign (%) followed by the 
command. 


The REQUEST Command 


The REQUEST command displays a message at a system operator’s terminal and optionally 
requests a reply. | 


REQUEST "message-text" 


REQUEST/REPLY "message-text" 
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MODULE 5 — 
MANAGING FILES 


MANAGING FILES 51 


INTRODUCTION 


File management on a VMS system involves moving files between devices, directories, and/or 
systems; protecting files from undesired manipulation; and maintaining and organizing collections 
of files in a directory. 


The VMS system provides the following means to help manage files: 


Devices that store files. 


A file system that organizes, protects, and retrieves files stored on the system. 


Commands and utility programs that allow you to communicate with the devices and the 


system. 


This module shows you how to organize and maintain a collection of files. 


OBJECTIVES 


To store and retrieve the many files used during daily operations, and to protect these files from 
unauthorized use, you should be able to: 


Locate files stored on disks. 
Locate directories in directory trees. 
Add and remove files from a directory. 


Display contents of files. 


Protect files from being accessed by unauthorized users. 


RESOURCES 


Guide to VMS Files and Devices 


VMS DCL Dictionary 
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FILE SPECIFICATIONS 


- A AS is. laa ly) related collection of ecords. 


¢ Use a file specification to identify a file you may wish to access. 


Table 5—1 illustrates the syntax of a file specification. 


Table 5-1: Syntax of a Local Disk File niin __ fe 
ea mca. ae 


's DCL= COMMAND _D AO: [SMITH] MYFILE.DAT; 7 \ 










Name Reference =~ ~~ ~—~——s&Rtules of Naming Example 

Device Storage device name 1 to 255 characters DBAO: 

Directory Catalogue of files 1 to 39 characters [SMITH] 

Name Name of file \ 0 to 39 characters MYFILE | 
Type Kind of file 0 to 39 characters DAT (0AW BE AMY fe? 
Version Unique number used to dif- 1 to 32767 (integer) 7 


ferentiate files with the same 
name and type 


The following characters are allowed in directory names, file names, and file types: 
e A through Z 

¢ 0 through 9 

e Underscore (_) 


¢ Dollar sign ($) 


F rae Ph Ae ©) Pi 6-4 TOL a ae See a ae Ts oe lf ee wee ae Ele Siow! 
Noes REVICE ¢ LD ec oRy . GoB DEL aT, ; 
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DEFAULTS FOR FILE SPECIFICATIONS 


- Each part of a file specification is called a field. 





- You can omit fields and allow the system to supply defaults for those fields 
« To override the default value for a field, supply a value for that field 


¢ The following table summarizes the defaults used by the system 


Table 5-2: File Specification Defaults 


Part of File 

Specification Default 

Device Device established at login by the system manager or specified by the last 
SET DEFAULT command 

Directory Directory established at login by the system manager or specified by the last 
SET DEFAULT command 

Name None 

Type Depends on the DCL command 

Version The highest version number 


i Ve pins, 2 TE fe gods 
No, SDM YO PS es 
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DEVICE SPECIFICATIONS - 37" >-s 


*+ Logical device name 


4 mA SOTO AlN HO ICAL NCTA NN 


— Synonym for a physical device name (Ex 


— Established by the system manager 
« Physical device name 
— Refers toa specific physical system device 
— Device code 
— Controller character (Optional) 
—- Unit number (Optional) 
¢ Generic device name 


— Specifies a group of devices. 


DVE i) 
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Table 5-3: Naming a Device 





Device Default 
Specification Function Value Value 

Device type code identifies device type 2-13 characters None 

Controller character Names controller to which de— One or more of the A 

vice is attached characters A-Z 

Unit number Names relative position on Decimalnumbersfrom 0 

_ controller of desired unit 0~65535 
Device specification Marks the end of the device —_: (colon) None 
delimiter specification 
NOTE 


Refer to Appendix A for further information regarding devices. 


Yaar ‘e rm 4 » ( r Pe one : 
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DIRECTORY STRUCTURE gt 


Pos ake 
vt Oe 


~ * Each disk contains a Master File Directory (MFD) that catalogs all User File Directories. 
( UFD S). WPELLOTE Tete AAD You 12. an eta ooo a 


Nyy 
-  Adirectory is a file that catalogs another set of files on a disk. Each UED contains the name. 
of each file and pointers to where. the file.is located on the disk. 
(3 . 


* — Directory files have a file type of DIR. 


*- Users can further subdivide their files by creating subdirectories. Subdirectories will be 
discussed later in this module. 
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DIRECTORY NAMES IN THE HIERARCHY 


Table 5—4: Directory Names 


Directory Type Example | Naming Convention 

Master File [OOO000} _ Each disk contains one MFD, named [000000]. 
Directory (MFD) 

User File [SMITH] Your user name is usually your UFD name. 


Directory (UFD) 


Subdirectory (SFD) [SMITH.PAYROLL] You choose the names for the subdirectories 
. you create. 


Figure 5-1: Naming Directories 


MED = 
LEVEL 0 [000000] 


| ees 
UFDs 
LEVEL 1 [USER1] [SMITH] 
eee 
SFDs . ae 
LEVEL 2 [SMITH.PAYROLL] [SMITH.INVENTORY] 


SFDs 
LEVEL 3 |: [SMITH.PAYROLL.MODULES] [SMITH.PAYROLL.DOCUMENTS] 
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The names given in the rectangles are directory names. 
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FILE MANIPULATION COMMANDS 


The following table lists examples of some DCL commands used to manipulate files. There are 


many qualifiers that modify the action of these commands. Refer to the VMS DCL Dictionary 
for more details. 





Table 5-5: File Manipulation Commands 


Operation Comments 


Creating a file without The CREATE command creates a new file without using a text editor. 
using a text editor 


$ CREATE MYFILE. TXT 


Copying a file The COPY command creates a new file from an old file. 


S COPY OLDFILE.TXT NEWFILE .TXT 


Changing an existing The RENAME command changes all or part of an existing file name. 
file name to new file 
name 


S$ RENAME OLDFILE.TXT NEWFILE .TXT 


Removing a file The DELETE command removes a file. A specific version number must 
be used to remove a file. ; 


$ DELETE MYFILE.TXT;2 


Removing files onan The /CONFIRM qualifier initiates a systern prompt to confirm whether 
interactive basis or not the file should be deleted. 
A "Y" response deletes the file; an "N" response does not delete the 
file. 


(System prompts): 

DISK: [SMITH] MYFILE.TXT;3 delete? [N]: 
DISK: [SMITH] MYFILE.TXT;2 delete? [N]: 
DISK: [SMITH] MYFILE.TXT;1 delete? [N]: 
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my 
Se ., 
ea 


Table 5—6: Manipulating Files in a Directory 


Operation 


Removing all versions 
of all files except the 
latest version 


S PURGE 


$ PURGE MYFILE.TXT 


Displaying the contents 
of a file at your termi- 
nal 


$ TYPE MYFILE.TXT 


Appending one or more 


files to the end of an- 
other file 


S$ APPEND OLDFILE.TXT NEWFILE.TXT 


occurrences of the 


specified — 


search-string(s) 


Comparing contents of | 


two files and display— 
ing differences 


Comments 


The DCL command PURGE removes all but the highest-numbered ver- 
sion of all files. 


The PURGE file-name command removes all but the highest-numbered 
version of a particular file. 


The TYPE command displays the contents of a file at your terminal. 
Note that only ASCII files may be displayed. 


CA BA be 


The APPEND command adds the contents of one or more files to the 
end of the specified output file. 


ae > Par ye 
ann et PN » TAC Fae Fae S 
/ PPE js [We WN mtn W Rene! meer 


gAadd “ 


“sat ~ 4, rN. bai LM, £¢ 
as 2) =e 2) 


string(s).. The “search ‘string. “March 13" must.be. enclosed. in quotation 
marks ‘because | it contains a space character. 


a imi Cal oh tl 


< $ SEARCH MYFILE.TXT "March 13" 


The DIFFERENCES command compares the contents of two files and 
creates a listing of the records that do not match. This listing goes to 
your terminal by default. a, gee 


LD. heigl 


SPA Ce pout 


S$ DIFFERENCES MYFILE.TXT YOURFILE.TXT 


Controlling the listing € The /OUTPUT qualifier tells the system to send the listing of Beles 


output from differences 


tos a a file. 


KK $ DIFFERENCES/OUTPUT=DIFF.TXT MYFILE.TXT YOURFILE.TXT 
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FINDING FILES AND DETERMINING THEIR 
CHARACTERISTICS 


Use the DIRECTORY command to 
¢ Find files on a peripheral storage device on your system 


¢ Display the contents of directories or the characteristics of files 
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Table 5-7: Using the DIRECTORY Command to Determine the Characteristics of Files 


Operation Comments 





Listing all files in your The DIRECTORY command iists all files and information about them 
directory | in your directory. 


S DIRECTORY 


Checking foraunique The file specification r must be included to obtain information.concerning 
file in your directory a particular. file in your directory. 


s DIRECTORY MYFILE. TXT 


re erttrerniernrnnire Miner ann Here mF 7 


Obtaining all informa- The /FULL qualifier overrides the default directory display, which_is 


tion about a particular BRIEF. Omit the file specification to obtain full information about all 
file in your directory files in in your directory. 


S$ DIRECTORY/FULL MYFILE.TXT 
or 


° § DIRECTORY/FULL 


Determining the size The /SIZE qualifier lists the size of files in 512-byte blocks used. 


Reena itary eos waft 


of files in your direce~ The The /SIZE=ALL qualifier. jists.the..size.of files both. in blocks used _and 
tory blocks allocated by the system. 


] 
JX$ DIRECTORY/SIZE [file-specification] 


or 


~é $ DIRECTORY/SIZE=ALL [file-specification] 


Determining the owner The /OWNER qualifier determines if the owner's UIC is displayed. 


LSM ree raceme ae a 


and protection ofafile The /PROTECTION qualifier. determines if the protection of the file is 


naa Ach apr Taam ait Y 
remnerarnedintiAn panarara Piet WAS 


displayed. . 


~&§ DIRECTORY /OWNER/PROTECTION MYFILE.TXT 





5-14 MANAGING FILES 


Using Wildcards in File Specifications 


Wildcards are used to 
¢- Specify more than one file 
¢ Abbreviate a file specification 


* Match one or more characters in directory names, file names, or file types 


Wildcards can be used in conjunction with each other or separately 


Table 5-8: Wildcards Used to Specify File Names, Types, and Versions 


symbol Meaning 
* Asterisk Match 0-39 characters in a file name, file type, or version number 
% Percent Match exactly one character in a file name or file type | 
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Example 5-1: Sample Directory File 


Directory WORK2: [SMITH] 


PAY.FOR;2 
PAYOFF .FOR;3 


Total of &S files. 


PAY.FOR;1 
PROBLEMS . TXT; 4 


PAYL.FOR;s1 
REPORT .MEM; 9 


Tabie 5-9: Using Wildcards to Specify Files | 


Directory 
Specification 
$ DIRECTORY PAY.FOR;* 


S DIRECTORY *.*;1 


Ss DIRECTORY *.*;* 


$ DIRECTORY PAYS .FOR; * 


$ DIRECTORY PAY*.*;* 


Description 
All versions of PAY.FOR 


All files with a version num-— 
ber of 1 


All files, types, and versions’ 


All versions of files with file 
type of FOR and file name 
beginning with PAY, followed 
by exactly one character 


All files whose first three let- 
ters are PAY, including all file 
types and all versions 


PAY2Z .FOR; 14 
REPORT. RNO; 6 


Corresponding Files 


PAY.FOR;2 
PAY.FOR;1 


PAY.FOR;1 
PAY1.FOR;1 


All files in the directory 


PAY1.FOR;1 
PAY2.FOR;14 


PAY 1.FOR;1 
PAY.FOR;2 
PAY.FOR;1 
PAYOFF.FOR;3 
PAY2.FOR;14 





‘Issuing the DIRECTORY command with no qualifiers or wildcards lists all files, types, and versions by default. 
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ORGANIZING YOUR DIRECTORY STRUCTURE 


> Files can be organized into subdirectories 

e Reasons for grouping files into subdirectories are to 
— Organize the directory structure 
— Protect them from accidental modification or loss 


— Decrease the time for the system to find them 


‘* Each UFD can have a maximum of!seven levels of subdirectories below it 


Dhak LAAN E PENS LM ad orttia ds AN RGR g NEE Maal gh gta AES 





¢ Files are usually grouped by 
— Function (all command files) 
— Application (all files for a given project) 
— Type (all FORTRAN files) 


-  Subdirectories can catalog other subdirectories as well as files 


MANAGING FILES 5-17 


CREATING A SUBDIRECTORY 


The command CREATE/DIRECTORY Idirectory. subdirectory] creates a subdirectory 


ERRATUM TOON 


Se agement a HAAN SAE RETA RE IONE tag 





The subdirectory name must be enclosed in brackets 

The subdirectory name includes the directory name where it is created 
Each subdirectory name is separated by a period 

The directory or subdirectory itself is a file 

— The directory or subdirectory has a file type of DIR 


— Version number of file type DIR ts 1 


Example: "ATES SI DMA abd iT 2 
( as wofD radeon, PM 8 8h 0p ee > 
$ CREATE/DIRECTORY/LOG [SMITH.DOC] eal ay ake 


(System response: ) 
SCREATE-I-CREATED DISK: [SMITH.DOC] created 


The directory [SMITH] is a UFD 

The subdirectory [.DOC] is the next level below the directory [SMITH] 
The file DOC.DIR;1 now resides in [SMITH] 

The /LOG qualifier displays on your terminal the fact that the subdirectory was created 


To create another subdirectory beneath the [.DOC] subdirectory: 


i$ CREATE/DIRECTORY directory subdirectory, subdirectory] | 


aR LORNA TS TONE Ae 1B Rar TT Ais 


Example: 


$ CREATE/DIRECTORY/LOG [SMITH.DOC.FORTRAN] 
SCREATE-I-CREATED DISK: [SMITH.DOC.FORTRAN] created (System response) 


The subdirectory [.FORTRAN] is listed under the subdirectory [SMITH.DOC] 
The file FORTRAN.DIR now resides in [SMITH.DOC] 


“ ea As ' f 
eh eS, # 
a ts = *. 
8 tes é 
B® OF 
mAoixe 
pe i i Fi & 
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a oe ~\ of 
% : Fy o ‘her . 
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USING THE SET DEFAULT COMMAND 


* The DCL command SET DEFAULT Brendes the default device and/or the directory name 
for your current process. 


— Aphysical device name must be terminated with a colon (:) 

— Adirectory or subdirectory name must be enclosed in square brackets 
© syntax: 

$ SET DEFAULT device—name:{directory—name] 


or 


$ SET DEFAULT [directory—-name.subdirectory—name] 


¢ Examples: 


$ SET DEFAULT DISK2: [BORGERT] (Device name and directory name change) 
S$ SET DEFAULT [SMITH.DOC] (Device name remains the same) 


USING THE SHOW DEFAULT COMMAND 


¢ The DCL command SHOW DEFAULT displays your current default device and mueerany 
names. 


¢ Examples: 


Se SHOW DEFAULT 
DISK: [SMITH] (System response) 
$ SET DEFAULT [SMITH.DOC] 
$ SHOW DEFAULT 
DISK: [SMITH.DOC] (System response) 
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* MOVING WITHIN A DIRECTORY HIERARCHY 


There are three characters used to move within a directory hierarchy. They are: 


+ Hyphen (-) £x. pip. [1 


enoe (.) (Con Nh BAN Wa fe. owl ae 0 byes by | OM QA bai ay FO Garb He poe CUED , 
£ Ellipsis (...) ANN WAYS Dau!) 
\ ex ® IDSIS (... 


The hyphen and period characters are normally used in conjunction with the SET DEFAULT 
command to move from your current directory to another directory or subdirectory. 

The ellipsis character, used with the DIRECTORY command, lists files in a directory and all 
subdirectories beneath it. 


Table 5—10: Characters Used to Specify Directories 


Symbol Meaning 
t — (hyphen) Move one level up in directory hierarchy . 
. (period) Move one level down in directory hierarchy (MUST be fol- 
lowed by a subdirectory name) 
Kom (ellipsis) Use current directory and all directories below it 


x7 
aoe .s oN ce * eon Gea Ba hae 
Ex, SET DEFAULT LT7-NAurp| 


a Oo 1" LOE OD + 
, ’ 
Pe vo i 
wut 





Or,’ ie oy 7 oy st ro 

an ee ee ee POS. fe af - nhs. F c 

- Crees Ae ee aay 2 Vey av ruy Fe Pars wy Sart’ Ley ver ae , ay a wet . i 
SS MER weld HE (Sogn Met RIE Pe age pce oe 
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Figure 5—2: File Specification in the Directory Hierarchy 


DIRECTORY NAME FILES CONTAINED COMMENTS 
MASTER FILE DIRECTORY THE MASTER FILE DIRECTORY 
{000000} USER1.DIR USER2.DIR (MFD) CATALOGS THE FILES 
SMITH.DIR 


THAT IMPLEMENT THE USER 
FILE DIRECTORIES. 


USER FILE DIRECTORY THE USER FILE DIRECTORY (UFD) 

(SMITH] CATALOGS FILES. NOTE THAT 
PROJ.DIR IMPLEMENTS THE 

SUBDIRECTORY [SMITH.PROJ]. 


SUBDIRECTORY THE SUB FILE DIRECTORY 
[SMITH.PROJ] MOD.DIR NOTE.TXT (SFD) [SMITH.PROJ] 
IS A LEVEL 2 DIRECTORY. 
LAB.DIR 
SUBDIRECTORY SFD [SMITH.PROJ.LAB}] 
{[SMITH.PROJ.LAB] MON .TXT TUE. TXT IS A LEVEL 3 DIRECTORY. 


LEVEL 8 IS THE MAXIMUM 
@) DIRECTORY LEVEL. 





G) [000000] SMITH.DIR (3) [SMITH.PROJJLAB.DIR 


(2) [SMITH] PROJ.DIR (4) [SMITH.PROJ.LABJMON.TXT 


TTB_X0328_88 
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Example 5-2: Using VMS Commands to Create and Maintain a Directory Hierarchy 


$ SHOW DEFAULT 

DISK: [SMITH] 
§ CREATE/DIRECTORY/LOG [SMITH.COM] 
*SCREATE-I-CREATED, DISK: [SMITH.COM] created 
$ CREATE/DIRECTORY/LOG [SMITH.UTLCOM] 
sCREATE-I-CREATED, DISK: [SMITH.UTLCOM] created 
$ CREATE/DIRECTORY/LOG [.UTLCOM.FIL] 
SCREATE-I-CREATED, DISK: [SMITH.UTLCOM. FIL] created 
$ CREATE/DIRECTORY/LOG [.UTLCOM.EDT] 
SCREATE-I-CREATED, DISK: [SMITH.UTLCOM.EDT] created 


S$ DIRECTORY [...] 
Directory DISK: [SMITH] 


COM.DIR;1 FORCALL.MAR;1 MMUL.FOR;1 POLA.QUO;1 
PRINT.FOR;1 RANDOM .FOR; 1 STRPROG. TXT; 1 UTLCOM.DIR;1 


Total of 8 files. 

Directory DISK: [SMITH.UTLCOM] 

EDT.DIR;1 FIL.DIR;1 

Total of 2 files. 

Grand total of 2 directories, 10 files. 


1, t 
*$ RENAME ([SMITH]*.MAR,*.TXT [.UTLCOM.FIL]*.* — moe (ies Reryecev Dice | 
S$ SET DEFAULT [.UTLCOM.FIL] 
S$ DIRECTORY 


Directory DISK: [SMITH.UTLCOM.FIL]} 
FORCALL.MAR;1 STRPROG.TXT;1 
Total of 2 files. 
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PROTECTING DISK AND TAPES 


Figure 5-3: File Access to Disk and Tape Volumes 
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PROTECTING FILES IN YOUR DIRECTORY 
HIERARCHY 


Change file protection to: 
+ Restrict access to your files 
- Prevent unauthorized moving or deletion of files 


se Assign a special protection.code-for_all-files-created_in.a particular directory. 


¢ Delete a subdirectory 


Three Levels of Disk File Protection 


* Volume Protection 

— Controls who can access a particular. disk volume 
¢ Directory Protection 

— Controls who can access a particular directory 


° File Protection 


— Controls who can access a particular file 


‘) User Identification Code (UIC-based) protection 
zy Access Control Lists (ACLS). 


be k 
ah Ge nqeemeery oo 
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* UIC-Based Protection 


- Format: {group,member] ~~ ma gS 
— Can be either numeric or aishancmedc 
— Group = 0-37777 (octal numbering system) 
— Member = 0-177777 (octal numbering system) 
¢« Examples: 
— Numeric: [100,30] 
— Alphanumeric: [GROUP11,SMITH] 


¢ The default protection mechanism 


* Each file is assigned a protection code when.it is created 


hte a arin haa ond Lacie 


- The system manager assigns UICs to all users 


* Protection codes are checked against a user's UIC before allowing them access to a file 


- By default, the file UIC matches the user's UIC 
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Figure 5—4: interaction of Access Categories 
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> Figure 5-5: Elements of a Protection Code: Determines Which Users Have Access to a 
File 


PROTECTION CODE 


(S:RWED, O:RWED,G:RE,W) 


PROTECTION CODE 7 
DELIMITER 


USER CATEGORY 
SYMBOL (SYSTEM) 


USER CATEGORY 
DELIMITER 


USER CATEGORY 
ACCESS CODES (READ, 
WRITE, EXECUTE 

AND DELETE) 


USER CATEGORY 
SEPARATOR 


TTB_X0331_88 


5— 26 MANAGING FILES 


Table 5-11: Summary of Effects of Access Rights to Files 


(R)ead 


Disk Directory Canread list of 
files in directory 


Disk File Can read con— 
tents of file(s) 

Tape File Can read list of 
files on tape 


(W)rite (E)xecute (D)elete 


Can modify list Canaccessex- Can delete the directory 
plicitly named 

(Add files) files 

Read access 

also needed 


Can modify con— Can execute ex— Can delete file(s) 
tents of file(s) ecutable files 


Can add files Does not ap- Does not apply 
on the volume ply CAN et Wate 


Table 5-12: Determining a User’s Category by Comparing User’s UIC to File Owner’s UIC 


Category Group Number Member Number 

SYSTEM 0-10 (Octal) Does not matter 

OWNER Matches group number of file UIC Matches member number of file UIC 
GROUP Matches group number of file UIC Does not matter 

WORLD Does not matter Does not matter 
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DETERMINING AND ALTERING FILE PROTECTION 


ik Tab 5—13: Commands Used to Determine and Alter File Protection 


Operation Comments 


Displaying the default |The default protection applies to all ay created files in the current 
protection assignedto directory. 
new files 


1 
1s SHOW PROTECTION 


Obtaining the protec— Displays the current protection of an existing file. 
tion code of a given 


file 

Ks DIRECTORY/PROTECTION MYFILE.TXT 
Changing the default The default protection, once changed, affects all future files created 
protection assignedto _in_ this particular directory. Files create sated before changing..the. default 
new files protection. will. retain. the. previous protection. 


1 
ts SET PROTECTION=(S: RWED,O:RWED, G:RWE, W: ewe) /DErAuER” 


Changing the protec- The protection code can be ii to allow more or less access to 
tion code of an exist- an existing file. 
ing file 


+4 SET PROTECTION=(S:RWED,O:RWE, G:RW, Wi ) MYFILE. TAT 





NOTE 


If you omit a protection category when you issue the SET PROTECTION command, the 
protection for that category remains unchanged. 
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Example 5-3: Changing Your Default Protection Code 


S$ SET DEFAULT [(SMITH.DOC} 


S SHOW PROTECTION 
SYSTEM=RWED, OWNER=RWED, GROUP=RE, WORLD=NO ACCESS 


$ DIRECTORY/OUTPUT=DIRECTORY.LIS 
$ DIRECTORY/OWNER/PROTECTION 


Directory DISK: [SMITH.DOC] 


DIRECTORY .LIS;1 [100, 200] (RWED , RWED, RE, ) 
EDT.DIR; 1 (100, 200) (RWE, RWE, RWE, RE) 


Total of 1 file. ae: 
$ SET PROTECTION=(S:R,G:R) /DEFAULT on OK dee 'y ie, 


$ SHOW PROTECTION 
SYSTEM=R, OWNER=RWED, GROUP=R, WORLD=NO ACCESS 


$ DIRECTORY/OUTPUT=DIRECTORY.LIS 
$ DIRECTORY/OWNER/PROTECTION 


Directory DISK: [SMITH.DOC] 


DIRECTORY.LIS;2 [GROUP11, SMITH] (R, RWED,R, ) 
DIRECTORY .LIS;1 {[GROUP11, SMITH) (RWED, RWED, RE, ) 
EDT.DIR; 1 [GROUP11, SMITH} (RWE, RWE, RWE, RE) 


Total of 2 files. 
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DELETING A SUBDIRECTORY 


- Before a subdirectory can be deleted, all files cataloged in that subdirectory must be deleted. 


* Set your default to the directory or subdirectory containing the subdirectory name to be 
deleted (SUBDIRECTORY.DIR file). 


¢ The protection on the subdirectory to be deleted must allow the owner DELETE access. 
The directory protection must be changed to reflect this, since the system never assigns 
DELETE access to a DIR file type. 


¢ The subdirectory can now be deleted. 


Example 5—4: Deleting a Subdirectory from a Directory Hierarchy 


S SET DEFAULT [SMITH.DOC] 
$ DIRECTORY 


Directory DISK: [SMITH.DOC] 


CLASS .LIST; 4 CLOCK.EXE;1 COLOR .COM; 4 DEG.EXE;1 
JOE_EVE.TPUSSECTION;1 MYFILE.TXT;1 NOTE .COM; 4 
REMIND .EXE; 1 REMLOG .EXE; 1 TRNG. PLAN; 6 VT100 .CLR;1 


Total of 11 files. 


S$ DELETE *.*;* 
S$ DIRECTORY 
*SDIRECT-W-NOFILES, no files found 


SET DEFAULT [SMITH] 

DELETE DOC.DIR;1 
*SDELETE-W-FILNOTDEL, error deleting DISK: [SMITH]DOC.DIR;1 
-RMS-E-PRV, .insufficient privilege or file protection violation 


$ SET PROTECTION=(0:RWED) DOC.DIR 


<n IN 


S$ DELETE DOC.DIR;1 


$ DIRECTORY DOC.DIR 
SDIRECT-W-FILES, no files found 
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Example 5—5: Removing Subdirectories from a Directory Hierarchy 


S SET DEFAULT [SMITH] 

S DIRECTORY (SMITHsw«] 

Directory DISK: [SMITH] 

DOG. DIR: 1 MYP TUE. AT e4 MYTEX. «TXT SI THs totes 
Total of 4 files. 


Directory DISK: [SMITH.DOC] 

FORTRAN .DIR;1 MYY TLE «TXT et MYTEXT.TXT;1 i, Ws ering in 
YOUR.FILE;1 

Total of 5 files. 


Directory DISK: [SMITH.DOC.FORTRAN] 
MYFILE.TXT;1 MYTEXT .TXT;1 THRU Lele YOUR. FILE; 1 
Total of 4 fiies. 


Grand total of 3 directories, 13 files. 

S$ SET PROTECTION=0:RWED [SMITH...]*.*;* 

$ DELETE [SMITH...J]*.*;* 

%SDELETE-W-FILNOTDEL, error deleting DISK: [SMITH]DOC.DIR;1 
-RMS-E-MKD, ACP could not mark file for deletion 
-SYSTEM~-F-DIRNOTEMPTY, directory file is not empty 
*SDELETE-W-FILNOTDEL, error deleting DISK: [SMITH]FORTRAN.DIR;1 
-~RMS~E-MKD, ACP could not mark file for deletion 
-SYSTEM-F-DIRNOTEMPTY, directory file is not empty 

S$ DIRECTORY [SMITH...] 

Directory DISK: [SMITH] 

DOC. DIR: I 

Total of 1. Ei ie. 


Directory DISK: [SMITH.DOC] 
FORTRAN.DIR;1 
Total of 1 file. 


Grand total of 2 directories, 2 files. 

S DELETE (SMITH...J]*.¥*;* 

SDELETE-W-FILNOTDEL, error deleting DISK: [SMITH]DOC.DIR;1 
~RMS-E-MKD, ACP could not mark file for deletion 
-SYSTEM-F-DIRNOTEMPTY, directory file is not empty 
$ DIRECTORY [SMITH...] 

Directory DISK: [SMITH] 

DOC .DIR;1 

Total of 1 file. 

$ DELETE [SMITH...]*.*;* 

S$ DIRECTORY [SMITH...] 

SDIRECT-W-NOFILES, no files found 
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> Access Control Lists 


* An optional layer of protection 
¢ Can be used for more control than UlC—based protection 
- Usually used when access is to be provided for specific users but not all users on a system 
¢ Based on identifiers 
— Users can have one or more identifiers 


— Files specify access rights for holders of various identifiers 
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Commands to Obtain ACL Information 


SHOW ACL file-—name 
DIRECTORY/ACL file~name 
DIRECTORY/FULL file-name 


DIRECTORY/SECURITY file-name 


Creating an Access Control List 








The DCL command EDIT/ACL file-name invokes the ACL editor 


Access Control List Entries (ACEs) can be added to the ACL 


Fe EEN ASR ALN AAS FUE PLP RG BY oP 


— No limit to the number of ACEs contained in an ACL 
— No limit to the number of ACE characters contained in an ACL 
—  ACEs are enclosed in parentheses 


Syntax: 


(TYPE, [OPTIONS],[ACCESS]) | 


The first field indicates the group or subset of a group that will have access to files 
The second field indicates options (if any) that apply to the ACE 


The third field indicates the type of access to be granted to the file (READ, WRITE, EXE- 
CUTE, DELETE, CONTROL, NONE) | — 
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Example 5—6: Modifying an Access Control List 


S$ 


ty 


DIRECTORY/FULL MYFILE.TXT 
Darectory DISK: [SMITH] 


MYF ILE. TXT FI File ID: (25168,6,0) 

Size: 17-3 Owner: [GROUP11, SMITH] 

Created: 17-DEC-1986 14:18 Revised: 17-DEC-1986 14:24 (3) 
Expires: <None specified> Backup: <No backup recorded> 

File organization: Sequential 

File attributes: Allocation: 3, Extend: 0, Global buffer count: QO, 


No version limit 
Record format: 
Record attributes: 


Variable length, maximum 47 bytes 
Carriage return carriage control 


Journaling enabled: None 

File protection: System:RWED, Owner:RWED, Group:RE, World: 
Access Cntrl List: None 

Total of 1 file, 1/3 blocks. 


$ EDIT/ACL MYFILE.TXT 


(IDENTIFIER=VMS, ACCESS=READ+WRITE+EXECUTE+DELETE) 3.) 
CTRL/Z 


$ DIRECTORY/FULL MYFILE.TXT 


boa 


Nee 


Directory DISK: {SMITH] 


MYFILE.TXT;1 File ID: (25168,6,0) 

Size: 1/3 Owner: [GROUP11, SMITH] 

Created: 17-DEC-1986 14:18 Revised: 17-DEC-1986 14:45 (4) 
Expires: <None specified> Backup: <No backup recorded> 

File organization: Sequential 

File attributes: Allocation: 3, Extend: 0, Global buffer count: 0, 


No version limit 
Record format: 
Record attributes: 
Journaling enabled: 
File protection: 
Access Cntrl List: 


Total of 1 file, 


Variable length, maximum 47 bytes 

Carriage return carriage control 

None 

System:RWED, Owner:RWED, Group:RE, World: 
(IDENTIFIER=VMS , ACCESS=READ+WRITE+EXECUTE+DELETE) 


1/3 blocks. 


ee 


aon 
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* Deleting an Access Control List 


- Use the SET ACL command to.delete.an Access. Control List 


* Example: 


$ SET ACL/DELETE MYFILE .TXT 
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SUMMARY 


Directory Type Example Naming Convention 

Master File [OO0000)] Each disk contains one MFD, named [O00000}. 
Directory (MFD) | 

User File [SMITH] Your user name is usually your UFD name. 


Directory (UFD) 


Subdirectory (SFD) [SMITH.PAY ROLL] You choose the names for the subdirectories 
you create. 


Use the DIRECTORY command to: 
¢ Find files on a peripheral storage device on your system 


« Display the contents of directories or the characteristics of files 


You may want to change file protection to: 

¢ Restrict access to your files 

e Prevent unauthorized moving or deletion of files 

e Assign a special protection code for all files created in a particular directory 


* Delete a subdirectory 


There are two means of protecting files: 
— User Identification Code (UlC—based) protection 


— Access Control Lists (ACLs) 
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APPENDIX A—DEVICE INFORMATION 


Specifying Devices 


Figure 5-6: Device Specifications Used to Identify the Desired Device for a Given Oper- 
ation 






DEVICE SPECIFICATION 





VMS 
OPERATING 
SYSTEM 








om! 
iar 


VAX-11 DEVICES 





TTB_X0332_88_S 


5 


MANAGING FILES 5~- 37 


Table 5-14: Examples of Using Other Devices 


Operation | Comments 


Listing files in adirec— _Lists ail files in the directory [SMITH] located on the disk DBA2: 
tory on another disk 


$ DIRECTORY device—name:{[directory—name] 
S$ DIRECTORY DBAZ2: (SMITH] 


Locating a file in adi- Searches for the file name MYFILE.TXT in the directory [SMITH] lo- 
rectory on another disk cated on the disk DBA2: 


$ DIRECTORY device—name:{directory—name}file-name 
$ DIRECTORY DBA2: [SMITH]MYFILE.TXT 


Copying a file froman-— Copies the latest version of MYFILE.TXT from another disk to your 
other disk to yourde- default disk and directory 
fault disk and direc- 


tory 


$ COPY device—name:[directory—name]filename file-name 
$ COPY DBA2: [SMITH] MYFILE.TXT MYFILE.TXT 


Listing all files on a Lists all files on magnetic tape on device MTA2: 
tape device 


$ DIRECTORY device—name: 
$ DIRECTORY MTA2: 


Finding afileonatape Searches for the file MYFILE.TXT on magnetic tape on device MTA2: 
device 


$ DIRECTORY device—name:file~name 
S$ DIRECTORY MTA2:MYFILE.TXT 


Copying a file fromtape Copies the file MYFILE.TXT from the tape on MTA2: to your default 
to a disk disk and directory 


$ COPY device—name:file~-name disk:[directory—name]file—-name 
$ COPY MTA2:MYFILE.TXT *.*;* 
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Table 5—15: Moving a Hierarchical File Structure from one Disk Device to Another 
Command Comment 


The COPY command __ Copies ail versions of the files in and below the SFD [SMITH.UTLCOM] 
on device DBAO: to the directory [JONES] on device DRA2:, preserving 
the hierarchical file structure. 


S$ COPY DBAO: [SMITH.UTLCOM...]*.*.* DRA2: (JONES...) *.*.* 


Copies all versions of the files in and below the SFD [SMITH.UTLCOM] 
on device DBAO: to the directory (JONES.UTLCOM] on device DRA2:, 
preserving the hierarchical file structure. If the file UTLCOM.DIR does 
not exist in the directory [JONES], the COPY command fails. 


$ COPY DBAO: [SMITH.OUTLCOM...]*.*;* DRA2: [JONES.UTLCOM...]*.*;* 
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Table 5-16: Codes for Some Supported Devices on a VMS System 


Code Device Type 
CS Console Storage Device 
DB RPO5, RPO6 Disk 
DD TU58 Cassette Tape 
DJ RA6O0 Removable Disk 
DL RLO2 Cartridge Disk 
DM RKO6, RKO7 Cartridge Disk 
DQ R80 Disk 
DR RMO3, RMO5, RM80, RPO7 Disk 
DU RA82, RA80, RA81, RC25, RD54, RD53 Disk, RX33, RX50 Floppy Diskette — 
DX RX01 Floppy Diskette 
DY RX02 Floppy Diskette 
LA LPA11—K Laboratory Peripheral Accelerator 
LC Line Printer on DMF32 
Ba Line Printer on LP11 
LT Interactive Terminal or Terminal Server 
MB Mailbox 
MF TU78 Magnetic Tape 
MS TS11, TU80 Magnetic Tape 
MT TE16, TU45, TU77 Magnetic Tape 
MU TA78, TK50, TU81 Magnetic Tape 
NET Network Communication Logical Device 
NL System “Null” Device 
OP Operator’s Console 
RT Remote Terminal 
war Interactive Terminal on DZ11 
TX Interactive Terminal on DMF32 
XA DR11-W General Purpose DMA Interface 
XD DMP-11 Synchronous Communications Lines 
XE | DEUNA Communication Device 
XF DR32 Interface Adapter 
XG DMF32 Synchronous Communications Lines 
XJ DUP11. Synchronous Communications Lines 
XM DMC11 Synchronous Communications Lines 
XQ DEQNA Communication Device 
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Table 5-17: Summary of Device Terminology 


Term 


Peripheral Device 


Mass Storage Device 


Record—Oriented Device 


Physical Device Name 


Logical Device Name 


Generic Device Name 


Cluster Device Name 


Definition 


A unit on the system used for information input, output, 
or storage. A device can be classified either as a mass 
storage device or as a record-oriented device. 


A device used for storing information on a magnetic medium. 
Examples inciude disks and tapes. 


A device used for reading and writing single units of data. 
Terminals, printers, and card readers are examples of 
these devices. 


A specific physical device on the system. Consists of a 
device—type code, a controller character, and a unit num— 
ber. 


A synonym for a physical device name. Often used to refer 
to a specific volume, regardiess of the device on which it 
is mounted. Usually the system manager sets up logical 
names. 


A group of devices, consisting of a physical device name 
that does not specify the controller and the unit number. 


Name of a device on a node in a cluster, consisting of a 
cluster node name and a device name or allocation class 
separated by a dollar sign. 
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Table 5—18: Generic Specification with the SHOW DEVICE Command 


Operation 
Using Physical Device Names 
Specifying a particular device 


$ SHOW DEVICE/FULL MTAO: 


Using Generic Device Names 


Specifying all devices of a given type 
except terminals 


$ SHOW DEVICE DM: 


Specifying all devices of a given type on a 
single controller 


$ SHOW DEVICE MTA: 


Specifying all devices of a given type at the 
same position on different controllers 


$ SHOW DEVICES TT1: 


Specifying all terminals 


$ SHOW DEVICE T: 


Specifying your assigned terminal 


$ SHOW DEVICE TT: 
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Comment 


Displays full information on the magnetic tape 
(MT) unit (0) on controller A. 


Displays brief characteristics of all RAGO devices 
(DU). 


Shows brief characteristics of all MT magnetic 
tape devices on controller A. | 


Displays brief characteristics of all terminals (TT) 
with unit number 71 on any controller. 


Displays brief characteristics of all system termi- 
nals. 


Displays brief characteristics of your assigned 
terminal. TT: is a system—defined logical name 
equating to your terminal. 


APPENDIX B—NETWORKING INFORMATION 


Managing Files on Another VMS System in Your 
Network 


Methods of File Management in a Network 


¢ Use the SET HOST command 
— Enter SET HOST 


Both processors must be running DECnet 
You must know a user name and password of an account on the remote system 


— Enter DCL file—manipulation commands 
¢« Use an access-control string in your DCL commands 
— Include an access-—control string in your DCL file-manipulation commands 


A user name of an account on the remote system 
A password for the account on the remote system 


¢ Use a proxy account 
— Established by the system manager 
_-= Associates your user name with an account on the remote system 
— The remote account provides needed system values 
¢ Use the DECnet defaults 
— The system manager can establish a default DECnet account 


— The DECnet account supplies needed system values 
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Using DCL File—Manipulation Commands in a 
Non-VAXcluster Network Environment 


Two Node Specification Formats 


¢ Nodename:: 
— The remote system process obtains needed values from its default DECnet account 
(If there is no default DECnet account, your file-manipulation request fails) 
— You have file access rights based on the DECnet account UIC 
« Nodename"access control string”:: 
— The remote system creates a process using the access control string values 


— The new remote account supplies needed system values 
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Table 5-19: Examples of Specifying Files on Remote Nodes 


Example Comments 


Specifies file PAY.FOR;1 in the directory [SMITH] 
on disk DBA1: on remote node DIPPER:. 


S$ DIRECTORY DIPPER: :DBA1: [SMITH] PAY.FOR;1 


Specifies the same as above example. Access 
to the file uses the UIC of user SMITH. 


$ DIRECTORY DIPPER"SMITH CORONA": :DBA1: [SMITH] PAY.FOR;1 


Specifies the same as above example. The pro- 
cess supplies the defaults under the account for 
SMITH. 


$ DIRECTORY DIPPER"SMITH CORONA": :PAY.FOR;1 


Specifies the file PAY.FOR in the subdirectory 
[SMITH.DOC] on the default disk of user SMITH 
on node DIPPER.:. - 


$ DIRECTORY DIPPER"SMITH CORONA": : [SMITH.DOC] PAY.FOR 
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Table 5~20: DECnet-VAX DCL File—-Manipulation Command Summary 


Function Comments 


Adding the contents of one Appends the contents of file DEMO.DAT in the directory [JAFFE] 
or more files to the endofan-— on the remote node BOSTON:: to the file TEST.DAT in your 
other file (files may be local current directory on your locai node. 

or remote) 


$ APPEND input-file[,...] output—file],...] 
$ APPEND BOSTON"JAFFE ANN": :DEMO.DAT TEST.DAT 


Copying one or more files to Copies the file DEC12.DAT from your current directory to the 

or from a remote node directory [JANES] on the remote node SUPER::. Defaults on 
the remote node come from the UAF record specified within 
quotes. The same file name is retained. 


$ COPY input-file[,...] output—file[,...] 
$ COPY DEC12.DAT SUPER" JANES JIL"::*.* 


Creating a disk file on a re- Creates the file TEST.DAT in the directory [MODEL] on disk 
mote node DBA1: of remote node TRNTO::. 


$ CREATE file—specification 
$ CREATE TRNTO::DBA1: [MODEL] TEST.DAT 
Text is entered into file TEST.DAT 


<CTRL/Z> 

$. 

Displaying information about Lists the files in the subdirectory [JANES.SUB1] located on the 
a file remote node SUPER::. 


$ DIRECTORY file—specification 
S$ DIRECTORY SUPER"JANES JIL": : [JANES.SUB1] 


Displaying the contents of a Displays the file PAY.DOC;1 in the directory [GREEN] on disk 
file at a terminal on a remote DBA1: located on remote node DIPPER::. 
node 


$ TYPE file-specification 
$ TYPE DIPPER: : [GREEN] PAY.DOC;1 


Deleting one or more files at Deletes ail versions of the file PAY.FOR in subdirectory [JONES.SUB1] 
a remote terminal located on remote node SUPER::. 


$ DELETE file-specification 
$ DELETE SUPER"JANES JIL":: [JANES .SUB1] PAY.FOR; * 
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Using DCL File—Manipulation Commands in a 


VAXcluster Environment 


Two Cluster Device Specification Formats 


1. Format Example 


node-name$device-name PETERSDUAT1: 


— Node name (name of HSC50 or VAX) 
— Dollar—sign ($) 
— Device name 
2. Format Example 


Sallocation—class$device—name $1$DUA0: 


— Dollar—sign ($) 
— Allocation class (a number between 0 and 255) 
. —  Dollar—sign ($) 


— Device name 
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Table 5-21: Commands Used to Determine the Nodes and Devices in Your Systems En- 


vironment 
Operation Command/Example Comments 
Determining the names s$ sHOWNET | Displays a list of nodes in your network. 
of nodes in a network | 
Determining the names _ s$ sHOW CLUSTER Displays a list of nodes (HSC and VAX) in 
of nodes in a VAX- your cluster. 
cluster system 
Determining the names $ SHOW DEVICES Displays a list of devices accessible to your 
of devices accessible node. 


to your node 
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MODULE 6 


CUSTOMIZING THE 
USER ENVIRONMENT 


CUSTOMIZING THE USER ENVIRONMENT 6-1 


INTRODUCTION 


In earlier modules, you have learned to enter commands to the operating system and to specify 
the locations of devices, directories, and files. The command strings and device and file speci- 
fications that perform these operations are sometimes lengthy and complex, which can lead to 
typographical and syntactical errors. 


This module introduces logical names and demonstrates how to use them in place of complicated 
device and file specifications in command strings. It also explains how to create and use symbols 
to tailor the command language. Finally, it describes how to define terminal keys to perform 
frequently used functions. 


OBJECTIVES 


To tailor the user environment, you shouid be able to: 


&, 


( * Create and use logical names for file access. 


> — Use the logical names the VMS system defines for all users. 


‘t})* Create and use symbols as command synonyms. 


a 
e 


ECORI 


RESOURCES 


Define and use terminal keys to speed up execution of frequently. used DCL commands. 


a 


* VMS DCL Dictionary 
e VMS DCL Concepts Manual 
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+ LOGICAL NAMES! 


- A logical-name-is-a-name_you.can.use in place of.all.or.part.of.a file specification 
¢  Itis used to 
— Achieve device and file independence in programs or procedures 
— Reduce typing and improve readability (used as replacement for long file specifications) 


— Pass data among programs, or between a command procedure and a program 


TEU AF OV AI RP IIIS PN 


¢ Format: : 


Ye & xa 


ry 
om, 


5 fa) 
os 


Vode, 
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a% 
ae 


& 


4< $ DEFINE logical name w equivalence stringJ....] f Fie 
, OF Goad 
7 $ ASSIGN equivalence-name [,...] logical-name/ = 
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fie a 
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op 
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OS ae : ¢ 7 pees 
we Pe dad ™ ; 4 te 4 
TD % oe : 
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id 
ms 3 
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CH 
« Logical names and their equivalence strings can each have a maximum of 255 characters 
(including alphanumeric characters, dollar signs, and underscores) 
« Any other characters must be enclosed in quotation marks 


¢ Stored in logical name tables 
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¥% Logical Name Tables 


r= Private 


- Process logical name table 


— Used only by your process | 


ahgiGramavent 





— ‘(PROCESS DCL command qualifier 


*™. 
Tomes eee Anan term 


r= Shared 


* Job-wide logical name table 
— Used by your process and its subprocesses - 
— “NOB - DCL command qualifier 

. Group logical name table 


— Used by UIC group member processes | 


— Privilege is needed to add logical names to this table! 


ai ae 


— GROUP - DCL command qualifier 


° System logical name table 


— Used by all system processes { 


— GUN Es is needed to add logical names fo this table | . 


hay, 


//SYSTEM DCL command qualifier 


nN 
att! 
Sees nue 
eee Biles Lteegs tet 


oy 
N\ 
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Mang get 
% 


Figure 6-1: The Relationship Between Your Terminal, the Operating System, and the 
Logical Name Tables Associated with Your Process 








$ logical-name command 


PROCESS 
LOGICAL 
NAME 

TABLE 


TERMINAL 


JOB-WIDE 
LOGICAL 
NAME 
TABLE 


VMS 
COMMAND 
LANGUAGE 
INTERPRETER 


GROUP 
LOGICAL 
NAME 
TABLE 


VMS 
OPERATING 
SYSTEM 





SYSTEM 
LOGICAL 
NAME 





TABLE o 
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Common User Operations Dealing with Logical Names 


* Display the contents of logical name tables 

¢ Determine the equivalence string of a logical name 

¢ Add or alter logical name assignments in your process logical name table 
¢ Override system—defined logical names in your process logical name table 


¢ Remove a logical name from your process logical name table 
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¥ Y & ; . 
pr A's o aN Sy gia 
- yd! 
y 





Adding Logical Names fe | 


fy / 
Pay: 


| ASSIGN command Se oo ns tees 
~~ ka 7 ye sat _ 


Me, 


Format: ee TP uF 


$ ASSIGN(/table-name]|/mode-name} equivalence-namef{,...] logical-name{:] 


een nee) 
Example: GL) ot 
fe" . \ 
$ ASSIGN DISK: [SMITH.UANDC] MINE a) ee Yih 

_* DEFINE command er a 
| Ms 
Format: 
| $ DEFINE[/table—name][/mode-name] logical-namef[:] equivalence—namef|....] 
. . | eG 
 Exempe: sug ee 
ex. beck © : 
\ $ DEFINE MINE DISK: [SMITH.UANDC] ‘ | 

Cee. Mm Esha i 


so re eee 
Example 6-1: Using Logical Names to Abbreviate Device and File Specifications = ~~" ” 


$ CREATE/DIRECTORY/LOG [SMITH.LOG] 
SCREATE-I-CREATED, DISK: [SMITH.LOG] created 


$ ASSIGN [SMITH.LOG] MY_LOG 


$ COPY/LOG [SMITH]MYFILE.TXT MY _ LOG 
*%COPY-S-COPIED, DISK: [SMITH] MYFILE.TXT;1 copied to 
DISK: [SMITH.LOG]MYFILE.TXT;1 (1 block) 


S$ TYPE MY _LOG:MYFILE.TXT 

This is a file for use in displaying the use of logical names 
to abbreviate devices and file specifications. This is in 
the module entitled "Customizing the User Environment". 


$ 
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USING LOGICAL NAMES 


Logical Name Translation for Logical Names that Have 
Single Equivalence Strings 


¢ The system translates logical names automatically. 
* Logical name tables are searched for the first occurrence of a logical name. 


4€ Search order: 


') Process Logical Name Table 
2.) Job-Wide Logical Name Table 
2. Group Logical Name Table 

#, System Logical Name Table — 


- Translates left-most portion of all file specifications to see if it is a logical name. 


¢ Translates: 


— Up to 10 times (recursively). p.¢-! 
— Until no more equivalence names to be translated. 


— Until left-most component of the specification is not delimited by a colon, a space, a 
comma, Or an. end of line... 


carat 


— Until equivalence name is a logical name that has the TERMINAL attribute. If a logical 
name has the TERMINAL attribute, the translation is "TERMINAL" (completed) after the 
first translation. 


— Ifthe logical name has the CONCEALED attribute, the translation normally displays the 
logical name for the device, rather than the physical name for the device. 


- NOTE 


Both TERMINAL and CONCEALED are translation attributes. They are defined by using 
the /TRANSLATION_ATTRIBUTES= qualifier for either the DEFINE or ASSIGN DCL 
commands. 


F, : £ 
' oo : + a a4 aaa pet 
TIL EAS L A LS. 
i i ¢ RE Of 


ss, gh or om ye ' 
i i 4, a Ff ¥e 
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Sample Recursive Translation 


Command 


S$ DIRECTORY PROJECTS 


First table search (looking for PROJECTS) 


"PROJECTS" = "DISK USER: [ELLEN] " 


(LNMSPROCESSTABLE) 


Second table search (looking for DISK_USER) 


"DISK_USER" = "DBAO:" (LNMSSYSTEM TABLE) 


Result 


— DBAO[ELLEN] - Searched 


Derive 
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Displaying the Contents of Logical Name Tables 


/- Table 6-1: Displaying the Contents of Logical Name Tabies 





Command String/Example Comments 
$ SHOW LOGICAL By default, displays logical names from the process, job- 
apenas - s . 
wide, group, and system logical name tables 
$ SHOW LOGICAL/FULL Displays all of the attributes of logical names from the 
process, job-wide, group, and system logical name ta— 
| bles 
$ SHOW LOGICAL/PROCESS. Displays logical names from your process logical name 
table 
$ SHOW LOGICAL/JOB Displays logical names from your job—wide logical name 
table 
$ SHOW LOGICAL/GROUP Displays logical names from your group logical name ta- 
ble | | 
$ SHOW LOGICAL/SYSTEM Displays logical names from the system logical name 
zero he a ts eC feb 
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Example 6-2: Displaying the Contents of the Process, Job, Group, and System Logical 
Name Tables 


S$ SHOW LOGICAL/PROCESS 
(LNMSPROCESS_ TABLE) 


"SYSSCOMMAND" = " DISKSRTA1:" 

"SYSSDISK" = "DISK:" 

"SYSSERROR" = "_DISKSRTA1:" a 

"SYSSINPUT" [super] = "_DISK:" —~ E™% OF Aton Cet 
"SYSSINPUT" [exec] = " DISKS$RTAL:" MoT a toms. DEPT. Ge 
"SYSSOUTPUT" [super] = "_DISKSRTAI:" | 

"SYSSOUTPUT" [exec] = " DISKSRTAL:" 

wipe = "RTAL ° " 


$ SHOW LOGICAL/JOB 
(LNMSJOB_ 803E4E40) 


"SYSSLOGIN" = "DISK: [SMITH]" 
"SYSSLOGIN DEVICE" = "DISK:" 
"SYSSREM_ID" = "SMITH" 
"SYSSREM _ NODE" = "SUPER: :" 
"SYSSSCRATCH" = "DISK: [SMITH]" 


$§ SHOW LOGICAL/GROUP 
(LNMSGROUP_000011) 


"MY DISK" = "DJAO:" 
S$ SHOW LOGICAL/SYSTEM 


(LNMSSYSTEM_ TABLE) 


"DBGSINPUT" = "SYSSINPUT:" 

"DBGSOUTPUT" = "SYSSOUTPUT:" 
"DISKSBROWNY_SYS" = "DISK:" 
"SYSSANNOUNCE" = ".Welcome to Browny." 
"SYSSCOMMON" = "DISK: [SYSO.SYSCOMMON.]" 
"SYSSDISK" = "DISK:" 

"SYSSERRORLOG" = "SYSSSYSROOT: [SYSERR]" 
"SYSSHELP" = "SYSSSYSROOT: [SYSHLP]" 
"SYSSMAINTENANCE" = "SYSSSYSROOT: [SYSMAINT] " 
"SYSSMANAGER" = "SYSSSYSROOT: [SYSMGR]" 
"SYSSMESSAGE" = "SYSSSYSROOT: [SYSMSG]" 
"SYSSNODE" = "BROWNY::" 

"SYSSSYLOGIN" = "SYSSMANAGER:SYLOGIN.COM" 
"SYSSSYSDEVICE" = "DISK:" 

"SYSSSYSROOT" = "DISK: [SYso. }" 

= "SYSSCOMMON:" 

"SYSSSYSTEM" = "SYSSSYSROOT: [SYSEXE]" 
"SYSSUPDATE" = "SYSSSYSROOT: [SYSUPD]" 
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Determining the Equivalence of a Logical Name 


* Two commands are available to determine the equivalence of a logical name 
* Format: 
% $ SHOW LOGICAL logical-name. 
lteratively translates the logical name up to 10 levels until everything is resolved 
* $ SHOW TRANSLATION logical-name_ 


Displays the first equivalence string it finds and stops (no iteration is performed) 


Example 6-3: Determining the Value of a Logical Name 


S ASSIGN DJAO: DISK1 
S$ ASSIGN DISK1: MYNAME 


S$ SHOW TRANSLATION MYNAME 

MYNAME = "DISK1:"  (LNMSPROCESS TABLE) 

S$ SHOW LOGICAL MYNAME 

"MYNAME" = "DISK1:" (LNMSPROCESS TABLE) 
1 "“DISK1I" = "DJAO:" (LNMSPROCESS TABLE) 
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+ Deleting Logical Names 


Table 6—-2: Commands to Delete Logical Names 


Operation 


Delete a logical name 
assignment 


Command String/Example 
$ DEASSIGN [ logical—name ] 


$ DEASSIGN MYFILE 


*° § DEASSIGN/ALL 


ety TBE, 


S$ DEASSIGN/JOB 


$ DEASSIGN/GROUP 


S$ DEASSIGN/SYSTEM 


Comments 


Deletes the logical name MY- 
FILE from your process logical 
name table. | 


Deletes all assignments that you 
have placed in your process log— 


eS PAT IIA pe 


ical name table. 


Deletes a logical name in your 
job table. 


Deletes a logical name in your 
group table. GRPNAM privi- 
lege is needed. 

Deletes a logical name in the 


system table. SYSNAM privi- 
lege is needed. 
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Example 6-4: Assigning, Changing, and Deleting Logical Name Assignments 


$ ASSIGN DJAO: DISK1 
$ ASSIGN DISK1: [SMITH] LOG 
$ SHOW LOGICAL/PROCESS 


(LNMSPROCESS TABLE) 


"DISK1" =-"DJAO:" 

"LOG" = "DISK1: [SMITH]" 
"SYSSCOMMAND" = " DISK:" 

"SYSSDISK" = "DISK:" 

"SYSSERROR" = " DISKSRTA1:" 
"SYSSINPUT" [super] = "_DISK:" 
"SYSSINPUT" [exec] = " DISKSRTAI:" 
"SYSSOUTPUT" [super] = " DISKSRTAI1:" 
"SYSSOUTPUT" [exec] = " DISKSRTA1:" 
sa hd i hd = "RTAL =" 


$ ASSIGN DJA1: DISK1 
%DCL-I-~SUPERSEDE, previous value of DISK1 has been superseded 


S$ SHOW LOGICAL/PROCESS 
(LNMSPROCESS_ TABLE) 
"DISK1" = "DJAI:" 


"LOG" = "DISK1: [SMITH] " 
"SYSSCOMMAND" = " DISKSRTA1:" 
"SYSSDISK" = "DISK:" 

"SYSSERROR" = " DISKSRTA1:" 
"SYSSINPUT" = " DISKSRTA1:" 
"SYSSOUTPUT" [super] = " DISKSRTA1:" 
"SYSSOUTPUT" [exec] = " DISKSRTAI1:" 
Ld iad i ef = "RTAL © vt ay 


$ DEASSIGN/ALL 
$ SHOW LOGICAL/PROCESS 


(LNM$PROCESS_ TABLE) 


"SYSSCOMMAND" = " DISKSRTA1:" 
"SYSSDISK" = "DISK:" 

"SYSSERROR" = " DISKSRTA1:" 
"SYSSINPUT" = " DISKSRTA1:" 
"SYSSOUTPUT" [super] = " DISKSRTA1:" 
"SYSSOUTPUT" [exec] = " DISKSRTA1:" 
feepeye sy = "RITAIL:" 

$ 
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*« System—Defined Logical Names 


When you log in, the system: oa . 





* Defines a number of logical names and stores them in your process logical name. table 


CE AARC 


¢ Creates a job-wide logical name tabie for your process and altet.its potential subprocesses 


You may override these permanently or temporarily with the ASSIGN or DEFINE commands 


Refer to the following tables for lists of system—defined logical names 


portent 


Table 6—3: | Process/ Logical Names Defined by the System | 


_ Logical Name 


SYSSERROR 
SYS$OUTPUT 


SYSSINPUT 


TT 


Equivalence Name | 
Original value of SYS$INPUT, equated to your terminal for interactive 
use and command procedures. 


Default disk 2stablished at login. Can be changed by the SET DE- 
FAULT command. 


Default device to which the system writes messages. For an interactive 
user, the system equates SYS$ERROR to the terminal. 


Default output devices. For an interactive user, SYSS$OUTPUT is 
equated to the terminal. 


Default input device. For all interactive use, SYSSINPUT is equated to 
the terminal. For command procedures, it is equated to the command 
file on disk. 


Default device name for your terminal in interactive mode and for the 
console in batch mode. 
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ae 
wes : 
w 
4 


‘Job Logical’ ames Defined by the System 










ae Table 6—4: 
Logical Name — Equivalence Name 


« SYS$LOGIN Default disk and directory established at login time. This "home" direc— 
tory is specified in the authorization record. 


SYS$LOGIN_ DEVICE Default disk established at login. Unlike the logical name SYS$DISK, 
| SYS$LOGINDEVICE is not changed by the SET DEFAULT command. 








SYS$SCRATCH Default device and directory to which temporary files are written. This 
| is always equated to your default directory, ¢y. age pier Pie 16 pp}, Os 
*K Table 6—5: / ystem Logical Names Defined by the System 
Logical Name Equivalence Name 
SYS$SYSTEM Device and directory of operating system programs and procedures. 
SYS$HELP Device and directory name of system help files. 
SYS$LIBRARY Device and directory name of system libraries. 
SYS$8MESSAGE Device and directory name of system message files. 
SYS$SHARE Device and directory name of system shareable images. 
SYS$SYSDEVICE VMS system disk, device referred to in the system logical names listed 
| above. | 
SYS$NODE Current network node name for the local system, if DECnet is active 


on the system. 
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* Specifying Logical Name Access Modes 


y+ /USER_MODE (temporary assignment) 
- /SUPERVISOR_MODE (default - permament assignment)! 


Duration of a Process—Private Logical Name 
Assignment 





- Supervisor mode assignments last until you 
— Log out 


— Assign the particular logical name to a different equivalence string 
— Remove the logical name assignment by using the DEASSIGN command 
+y* User mode assignments last: 


— Until the next image run in your process completes.execution. (An image is a program 
in its executable form.) 


Example 6-5: Using ASSIGN Command to Alter the Default Output Device of Your Pro- 


cess 
$ ASSIGN/USER_ MODE OUTPUT.LIS SYSSOUTPUT EX. of 6 ane Tad 
$ SHOW PROCESS E | 
$ TYPE OUTPUT.LIS aad 
22-OCT-1987 16:20:03.20 RTAL: User: SMITH OF ; 
Pid: 202001F8 Proc. name: SMITH UIC: [(GROUP11, SMITH] DUTP ET: 
Priority: 4 Default file spec: DISK: [SMITH] a ae 


Devices allocated: DISKSRTAI: 
$ 
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4 USING DCL SYMBOLS 


- Symbols are names that represent character strings or numeric values 





* Can be used as DCL command synonyms allowing the user to tailor DCL command format 
¢« Equated to an equivalence string (which is enclosed in " ") 


— Complete command string. 


— Portion of a command string 


FEROS AO ES Bi HOE rl TOT TORON EES 


% 


Stored in one of two tables (each process has its own) 


gi — LOCAL 


Bs on a hd tama a 


\ . = GLOBAL 


** Often defined in a command file named LOGIN.COM (usually located in your default direc— 
tory) for use in every terminal session 


acaeen st y, 

ST SE ata 
NS 

Aus 


— Defined with = or == (assignment operators) /Fe2"are 
Hoa wat = [| Aen 2") 


Hem 


neh art cae ole v ce } 
cts 


greg F 
‘rearig ue bedi f 


BB erm: 


re) 


¥~ — Global with== — : 


tb te » 
goies Rares wie, sidebar teem t 


— Example: 
$ SD == "SET DEFAULT" 


Ta a 


ee Can abbreviate symbol.names using the asterisk.(*)as the abbreviation character 


« Example: \ es cn sseeinecn <4 
" ) ae, LORGQOT = LOGON PLA kde 


— $M*AIL="MAIL" * 


— The abbreviations "M", "MA", "MAI", and "MAIL" now will invoke the Mail utility 


© Translation is not iterative |! | 


Be aca halal 





¢ Examples: 
=— 5 PROTECT == "SET PROTECTION=(S:R,0O:RWED,G:R,W) " } 


— $ PROTECT [SMITH]*.*;* ewe 
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Figure 6-2: The Relationship Between Your Terminal, the Operating System, and Your 
Global Symbol Table 


$ command-synonym command 
















GLOBAL SYMBOL 
TABLE 
we 
a 
VMS 
COMMAND 
LANGUAGE 
INTERPRETER 
LOCAL SYMBOL 
TABLE 
St ; 
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> Table 6-6: Commands for Displaying and Deleting DCL Symbols 


Operation Command String/Example 

_w Displaying Symbols 
Displaying a sin- $ SHOW SYMBOL/GLOBAL leone 
gle symbol $ SHOW SYMBOL/GLOBAL GO 


Displaying allsym- $ SHOW SYMBOL/GLOBAL/ALL 
bols 


Displaying allsym-— s$ sHoW SYMBOL/GLOBAL s* 
bols using a wild- 
card 


_* Deleting Symbols 


Deleting a single $ DELETE/SYMBOL/GLOBAL symbol~name 
symbol 
$ DELETE/SYMBOL/GLOBAL GO 


Deleting allsym-— = $ DELETE/SYMBOL/GLOBAL/ALL 
bols 
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Comments 


Displays the value of the 
symbol GO 


Displays the values of all 
symbols defined in your 
global symbol table 


Displays the values of all 
symbols defined in your 
global symbol table be- 
ginning with the letter “s" 


Deletes the symbol GO 
from your global symbol 
table 


Deletes all symbols from 
your global symbol table 


Example 6-6: Defining, Displaying, Using, and Deleting DCL Symbols 


S Di == "DIRECTORY/OWNER/PROTECTION" 
S$ GO == "SET DEFAULT" 


$ RETURN == "SET DEFAULT SYSS$LOGIN" 
$ SHOW SYMBOL/GLOBAL/ALL | 


_ $RESTART == "FALSE" 
-, $SEVERITY == "1" 
_$STATUS == "%X00030001" 
' DIRP == "DIRECTORY/OWNER/PROTECTION" 
GO == "SET DEFAULT" 
RETURN == "SET DEFAULT SYSSLOGIN" 


S$ GO SYSSSYSTEM 
$ DIRP DCL.EXE 
Directory SYSSCOMMON: [SYSEXE] 


DCL.EXE;1 [SYSTEM] 
Total of 1 file. 

$ RETURN 

$ DELETE/SYMBOL/GLOBAL/ALL 

$ SHOW /SYMBOL/GLOBAL/ALL 


SRESTART == "FALSE" 
SSEVERITY == "1" 
SSTATUS == "%X00030001" 


Cant Paar oe » 
rn Selene 4 


(RWED , RWED, RWED, RE) 
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CREATE 


DISPLAY 


«\) DELETE 


QUALIFIERS 


NOTES 


string 


= (LOCAL) 
== (GLOBAL) 


SHOW SYMBOL 


DELETE/SYMBOL 


/LOCAL 
/GLOBAL 


/ALL 


/LOCAL 


IDIS means DISPLAYING 
DEL means DELETING 
CRE means CREATING 


Used for: 

(DIS, DEL)! 
(DIS, DEL)' 
(DIS, DEL)! 


is the default 
for display and 
delete 


LOGICAL NAME 


‘Equated to all or part of a command | Used in place of all or part of a 
_ file specification 


~ ASSIGN or DEFINE 


~ SHOW LOGICAL or 


- SHOW TRANSLATION 
DEASSIGN | 
- Used for: 
/PROCESS (CRE, DIS, DEL)! 
/JOB 
/GROUP | (CRE, DIS, DEL)! 
/SYSTEM 
/ALL (DIS, DEL)! 
(DIS, DEL)’ 
(DIS) 
/ALL is the default 
for display 
/PROCESS is the default 
for create and 
delete 
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¥ D EFI Ni NG KEYS ( ow IY PER LOGIN SESSION Live ooS tl Law, doh 
lowty Ar Det LeveL) 
¢ Definitions often contain part or all of a DCL command string 
¢ Reduces typing of lengthy or frequently used DCL commands 
sina types and associated definable keys include 
— VT52-type terminals 
All definable keys located on the numeric keypad 


— VT100-type terminals 


All keys located on the numeric keypad 
<LEFT> and <RIGHT> arrow keys 


4 — Terminals with LK201 keyboards Cisne 220% 


All keys on the numeric keypad 

Keys on the editing keypad (except the <UP> and <DOWN> arrow keys) 

Keys on the function key row across the top of the keyboard (except function keys 
<Fi> through <F5>) 


° Keys <KPO> — <KP9>, <PERIOD>, <COMMA>, and <MINUS> must be enabled for definition 
| purposes. These keys are enabled by using either of the following commands: 





x $ SET TERMINAL/APPLICATION 
$ SET TERMINAL/NONUMERIC 


¢ Keypad keys <PF1> —- <PF4> can also be defined 


eect SSG RE Ata PON pceaieten dea bee 


: Format: ce “EX. DE Pine f fs SEY p a : eee . - ) 


+  $ DEFINE/KEY key-name equivalence string \ qualifiers — iene Tree, 


nee Seer 


* One or more of the following qualifiers may be used to alter the action of a defined ney 


\ ~*~ — /TERMINATE - Produces an automatic return! 2ire have le ¢ pitts Ke. (= the Lock one vedere 


“4 — /INOECHO - Suppresses the aisPray of the command being invoked 


fang ik Arb es ie PA ehee WOM hore: 


— /ERASE - Erases the characters on the current line before aaiaies and executing the 
- command invoked by the defined key 


3% —— /INOLOG - Suppresses the informational message you receive when you initially define 
a key 
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+ To display a key definition, issue the DCL commana: 





Example: 


S$ SHOW KEY/FULL PF1 
PF1 = “directory” 
(echo, noterminate, noerase,nolock) 


* To delete a key definition, issue the DCL command: 


3 DELETE/KEY key-name 


Example: 


$ DELETE/KEY PF1 
%DCL-I-DELKEY, HOME key PF1 has been deleted 
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SUMMARY 


A logical name is a name you can use in place . all or part of a file specification 

They are used to: 

— Achieve device and file independence in programs or procedures 

— Reduce typing and improve readability (used as replacement for long file specifications) 
— Pass data among programs, or between a command procedure and a program 


Logical names and their equivalence strings can each have a maximum of 255 characters 
(including alphanumeric characters, dollar signs and underscores) 


Any other characters must be enclosed in quotation marks 


stored in logical name tables 


System Defined Logical Names 


When you log in, the system: 


Defines a number of logical names and stores them in your process logical name table 


Creates a job—wide logical name table for your process and all of its potential subprocesses 


You may override these permanently or temporarily with the ASSIGN or DEFINE commands 


DCL Symbols 


Symbols are names that represent character strings or numeric values 

Can be used as DCL command synonyms allowing the user to tailor DCL command format 
Equated to an equivalence string (which is enclosed in " ") 

— Complete command string 

— Portion of a command string 

Stored in one of two tables (each process has its own) 

— LOCAL 

— GLOBAL 
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Defining Keys 
¢ Definitions often contain part or all of a DCL command string 


¢« Reduces typing of lengthy or frequently used DCL commands 


syntax: 

$ DEFINE/KEY key-name equivalence string /qualifiers 
To display a key definition, issue the DCL command: 
SHOW KEY/FULL key-name 

To delete a key definition, issue the DCL command: 


DELETE/KEY key-—name 
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MODULE 7. 
WRITING COMMAND PROCEDURES 


WRITING COMMAND PROCEDURES 7-1 


INTRODUCTION 


Command procedures are files consisting of DCL commands. They can be used to automatically 
execute command sequences that are needed repeatedly. In addition to the command verbs, 
qualifiers, and parameters commonly used at the interactive level, command procedures allow 
the use of DCL command language features that provide increased functionality and flexibility, 


including: 
- Symbols that can be used as numeric and string variables 
¢ — Instructions that allow you to control program flow 


° Lexical functions 


This module presents the material needed to create, test, and run a command procedure inter- 
activel oly. In a later module, you | will learn | how to run command ‘procedures independently c of your 


interactive process, as batch Jobs. 


Za eet aad 


f 
i 
; 
Hi 
< 
Se 
“hen 
a 
co 
cor 
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OBJECTIVES 


To write DCL command procedures, you should be able to: 
¢ Define what a command procedure is and describe why command procedures are used. 
¢ Create a command procedure, using standard DCL command elements. 
¢ Control terminal input and output in a command procedure by: 
_— Displaying messages on the terminal 
— Accepting input from the user 
— Redirecting input or output from the terminal to another location 
* Pass data to a command procedure using parameters. 
¢ Control the flow of execution within a command procedure using: 
— The IF command 
— The GOTO command a 


¢ Use the proper lexical function to obtain the information needed ina command procedure. 
RESOURCES 


¢ Guide to Using VMS Command Procedures 


¢ VMS DCL Dictionary 
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DEVELOPING A COMMAND PROCEDURE 


The steps you take to develop a command procedure are similar to the steps you take to develop 
any computer program in any language. The following steps are illustrated in Figure 7-1. 


1. Design the command procedure. 

¢ Determine what tasks the procedure should perform. 

¢ Decide what results the procedure should produce. 
2. Create the command procedure. 

¢« Use the text editor of your choice. 

¢ Specify the file type COM for the command procedure. 
3. Execute and test the command procedure. 


- _Use the "at sign" (@) to execute the procedure interactively. 


of + Use the DCL command SET VERIFY to: \ 
— Display each line of the procedure as it executes ~ 


No Help you locate errors if they occur -~ 


4. Modify and retest the command procedure, if necessary. 


* Repeat steps 2 and 3. 
- Use the DCL command SET NOVERIFY..after the procedure has been tested and 
p e rf ected : TOR at 2 hear 


5. Add comments to the command procedure so it is easy to read and maintain. Comments 
should: 
¢ Describe the procedure in detail. 


¢ Describe any parameters that are passed to the procedure. 
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Figure 7-1: Command Procedure Development Process | 


DEVELOPMENT STEP CORRESPONDING DCL 
COMMAND (IF ANY) 


DESIGN PROCEDURE NONE 





WRITE PROCEDURE $ EDIT filename.COM 









TEST PROCEDURE 





$ @filename.COM 


MODIFY PROCEDURE $ EDIT filename.COM 






RE-TEST PROCEDURE 
USING 
$ SET VERIFY 


$ SET VERIFY 
$ @fiiename.COM 





DID IT WORK? 





ADD COMMENTS 


TO PROCEDURE $ EDIT filename.COM 





TTB_X0335_88 
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Components and Conventions 


Consistent formats and clear programming style make your command procedures easy to read, 
test, and maintain. Example 7—1 illustrates some of the conventions below. 


« DCL command lines 
— Use full command names, no abbreviations 
— Precede each command line with the dollar sign ($) prompt 


— Continue a line by p «ie Oe sar aie ama Hine, a not. t begin. the. continued 
line with a dollar sign) = 3... eo 


¢ Comments 
—  Precede all comment lines with an exclamation mark (!) 
— Use blank comment lines to separate blocks of commands 
e« Labels 
— Use labels to mark locations within a procedure 
— Place the label on a line by itself 
— Follow the label with a colon (:) 
- Data lines 
— Place data in a command procedure immediately after the command that will use it 
— Do not place a dollar sign at the beginning of a data line 


(Terminated by the first occurrence of the dollar sign) 
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Example 7-1: A Sample Command Procedure 


DNDN MNDNM MOMMA NUM UHUNNYNM 


MN MMNMUNMNMDY 


ee ee ee ee ee ee ee) 


SHOW DEFAULT 


REPORT1.COM 


This command procedure sets your default directory 

to the REPORTS.MONDAY subdirectory, prints out a report 
for Monday, returns you to your login device and 
directory, then exits. 

Set your default to the REPORTS.MONDAY subdirectory 

SET DEFAULT DISK1: [REPORTS .MONDAY] 


Check to verify you are in the correct directory 






~ 


Print out the report for Monday 
PRINT MONDAY.RPT 
Return to your login device and directory 


SET DEFAULT SYSSLOGIN 
EXIT 
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Execution of REPORT1.COM: 
Example 7-1: A Sample Command Procedure (Cont) 


$ @REPORTI 
Job MONDAY (queue SYSSPRINT, entry 44) started on WORKSTXAO 


‘Now try it with VERIFY turned on: 


SET VERIFY 
@REPORT1 
REPORT1.COM 


! 
! 
! This command procedure sets your default directory 

! to the REPORTS.MONDAY subdirectory, prints out a report 
! for Monday, returns you to your login device and 

! directory, then exits. | 

! 

{ 

! Set your default to the REPORTS.MONDAY subdirectory 

! 

SET DEFAULT DISK1: [REPORTS.MONDAY] 


! Check to verify you are in the correct directory 


SHOW DEFAULT 
DISK1: [REPORTS .MONDAY] 


7 


! Print out the report for Monday 


o— 


PRINT MONDAY .RPT 


MONDAY (queue SYSSPRINT 46) started on WORKSTXAO 
we 







1d directory 


re) 
Ss oat ee ty 


ra 
Return to your login device 


DMN MNUM YUNNAN UNH MU NNN YNMNUNUnUUUNUDOHNMNMNNNMN YN 


SET DEFAULT péssocrs 


EXIT a 
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LOGIN COMMAND PROCEDURE 


- is a command procedure that is executed automatically each time you log in 


a - Mu alled LOGIN.COM and placed in your default login directory. : i 


¢ Contains logical names, symbols, and other commands to. set.up.your terminal session 


EPI” SETA TERRI Nea! 


7K * Can be disabled for a particular session by typing NOCOMMAND after your user name at 
the Username:.prompt. 


- Example 7~2 shows a typical LOGIN.COM file 


7-10 WRITING COMMAND PROCEDURES 


Example 7-2: A Sample LOGIN.COM File 


LOGIN. COM 


Logical names for common files and directories 


ee ee ee ee 


ASSIGN SYSSLOGIN_DEVICE: [BLOOM.PASCAL] PASCAL 
ASSIGN SYSSLOGIN DEVICE: [BLOOM.GAMES] FUN 
ASSIGN SYSSLOGIN_ DEVICE: [BLOOM.PROCEDURES]CLEANUP.COM CLEANUP 


! Commonly used commands 


SED == "SET DEFAULT" 

HOME == "SET DEFAULT SYSSLOGIN" 

CLR == "SET TERMINAL/WIDTH=80" 

EDT == "EDIT" 

DS == "DIRECTORY/SIZE=ALL" 

SD == "SHOW DEFAULT" 

= "MAIL w 

PU == "PURGE/LOG" 

XX == "DELETE" 
! 
! Key definitions © fee . Aare © 
ee eo 

SET TERMINAL/APPLICATION KEYPAD ~ Gi 


DEF INE/KEY/NOLOG/TERMINATE PF1 "SHOW USERS" 
DEF INE/KEY/NOLOG/TERMINATE PF3 "SHOW TIME" 
DEF INE/KEY/NOLOG/TERMINATE KP9 "SHOW QUEUE/ALL/FULL LPAO' 
DEF INE/KEY/NOLOG/TERMINATE KPO "LOGOUT" 


DM MNMNN NN MNMN DMN UMMA YUN NOHUMOHOMNHUMN UHH HU VNU HNUNNOHYDM 


EXIT 
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TERMINAL INPUT/OUTPUT 


° Several DCL commands allow you to perform terminal input and output operations 
- These commands make use of predefined logical names 
¢« Terminal input and output operations are used to: 
— Display messages and command output on the terminal screen 
 — Prompt the user for input ()) ze Soe 2 RUD) 
— Redirect terminal output to a file 


— Allow the use of an interactive utility, such as an editor 


Table 7-1: System Logical Names Used with Terminal |/O 


Logical Name Description Associated File or Device 
(At Login) (During Execution 
. of a Procedure) 

SYS$COMMAND initial input stream for your Terminal Terminal 

process | 
SYSS$INPUT Default input stream for your =‘ Terminal Command Procedure File 

process 
SYSSOUTPUT Default output stream for your Terminal Terminal 

process | 
SYS$SERROR Default file to which the sys— ‘Terminal Terminal 


tem writes error messages 
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Performing Terminal Input and Output 


Table 7-2: Displaying information on the Terminal 


Command/Example | Comments 
$ WRITE SYSSOUTPUT string Character strings are enclosed in quotation marks. 


S$ WRITE SYSSOUTPUT "Hello" 


$ WRITE SYSSOUTPUT symbol The symbol’s value is automatically substituted. 


$ WRITE SYSSOUTPUT FILENAME 


$ TYPE SYSSINPUT Information to be displayed follows the TYPE com-— 
text , mand. A dollar sign marks the end of the informa— 
text tion. 

text 

$ 


$ TYPE SYSSINPUT 
MENU CHOICES: 
1. Add a user 
2. Remove a user 
3. List users 
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Example 7—3: A Sample of Output from a Command Procedure 


REPORT2 .COM 


This command procedure sets your default directory to the 
[REPORTS .MONDAY] subdirectory, prints out a report for Monday, 
returns you to your login device and directory, then exits. 


ee ee ee ee ee ee 


WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "Changing your default directory" 


! Set your default to the correct subdirectory 
SET DEFAULT DISK1: [REPORTS .MONDAY] 


WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "Printing the Monday report" 


! Print out the report for Monday 
PRINT MONDAY .RPT 
! Return to your login device and directory 


WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "Changing. back to your login directory" 


SET DEFAULT SYSSLOGIN 
EXIT 


DDN MNUMNMNOMNMNUDNNHDVMNMN UNA HMMNHMNMANMOHOONDAHAHDON MYM 


Execution of REPORT2.COM: 

$ @REPORT2 

Changing your default directory 

Printing the Monday report 

Job MONDAY (queue SYSSPRINT, entry 46) started on WORKSTXAO 


Changing back to your login directory 
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Table 7-3: Getting Information from the User 


Command/Example Comments 


*$ INQUIRE symbol "prompt" The prompt string is optional. The user's 
response is converted to uppercase. 
Multiple blanks and tabs are replaced 
with a single space. The response is 
then assigned to a local symbol. If no 
prompt string is supplied, the symbol 
name is used as the prompt. 


S$ INQUIRE NAME "Filename" 


$ READ/PROMPT=string SYSS$COMMAND symbol __ The user’s response is taken as is and 
stored in the local symbol. 


$ READ/PROMPT="Filename: " SYSSCOMMAND NAME 
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Table 7—4: Redirecting Input and Output | 


Command/Example 


$ ASSIGN/USER_MODE SYS$SCOMMAND SYSSINPUT 
OF 
$ DEFINE/USER_MODE SYSSINPUT SYSSCOMMAND 


$ @command_file-name/OUTPUT=output_file-name 


$ @COMFILE.COM/OUTPUT=COM STAT.DAT 


$ ASSIGN/USER_MODE output_file_name SYSSOUTPUT 
or 
$ DEFINE/USER_MODE SYSSOUTPUT output_file-name 


$ DEFINE/USER_MODE SYSSOUTPUT COM _STAT.DAT 


Comments 


The ASSIGN or DEFINE com- 
mand redirects the input stream 
from the command proce- 
dure file to the terminal. The 
/USER_MODE qualifier spec— 
ifies that the change remains 

in effect only while the next 
image is executing. 


Redirects output to the file 
you specify. 


Redirects the output stream 
to the file you specify while 
the next image is executing. 
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Example 7—4: Using Terminal Input and Output 


oo 

$! NOTICE .COM 

$! 

$! 

$! This command procedure creates a text file containing 
$! the message you specify, then mails it to DIST.DIS, 
$! a predefined distribution list. 

$! 

$! First, display instructions to the user. 

$! 

$ WRITE SYSSOUTPUT " " 

$ WRITE SYSSOUTPUT "Enter your message. Press CTRL/Z when done." 
$ WRITE SYSSOUTPUT " " 


$! Redirect the logical SYSSINPUT from the command 
$! procedure to the terminal. 


$ ASSIGN/USER_MODE SYSSCOMMAND SYSSINPUT 

$! Have the user create the message. 

$ EDIT MESSAGE.TXT 

S$! When the user exits the editor, the command procedure 


St continues. 


S$! Send the message. The lines following the MAIL 
$! command are data lines used by the MAIL utility. 
$! The dollar sign indicates the end of the data. 


$! 

$ MAIL 

SEND MESSAGE .TXT 

@DIST.DIS 

A NOTE FROM YOUR SUPERVISOR 
$! 

$! Leave the procedure 

$! 

$ EXIT 
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Symbol Substitution 


- In acommand procedure symbols can be used as 
— Command synonyms 
— Parameters 
— Variables 
- The system must translate symbols into their corresponding values 
* Some DCL commands automatically replace symbols with their values 
« Most DCL commands do not perform automatic symbol substitution 
¢ To force symbol substitution 
— Enclose the symbol name in apostrophes (’) 


—- In acharacter string, precede the symbol with two apostrophes (”) and end the symbol 
with a single apostrophe (’) 


¢ See Table 7—5 for examples 
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Table 7-5: Symbol Substitution Techniques 


Symbol Usage 


Command synonym (first item 
after $ prompt) 


In the right-hand side of an = 
or == assignment statement 


In an IF, WRITE, or INQUIRE 
command 


Ina DCL command that does 
not perform automatic sym- 
bol substitution 


Ina character string 


Concatenating two symbols 
ina DCL command that does 
not perform automatic sym- 
bol substitution 


Substitution Technique 


Automatic 
Automatic 


Automatic 


Example 


S$ XX = "DELETE" 
S$ XX FILE.TXI;1 


S$ COUNT = COUNT + 1 
$ FILESPEC = NAME + ".TXT" 


S IF COUNT .GT. 10 THEN - 
WRITE SYSSOUTPUT COUNT 


ourround the symbol with apos— s$ Run ’ PROGRAM’ 


trophes (’). 


Place two apostrophes in front 
of the symbol, and one apos-— 
trophe after it. 


Surround each symbol with 
apostrophes. Do not leave a 
space between the symbols. 
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S$ WRITE SYSSOUTPUT - 
"The file ’’ FILE’ exists." 


S$ PRINT ’NAME’ ’ TYPE’ 


Example 7—5: Using Symbol Substitution 


DMN MMOH MN HO MNMONNMNN HM NNDUMNNOMNMNNNNMNMADMONNM 


ee ee ee ee ee) 


REPORTS3 .COM 


This command procedure sets your default directory to the 
[REPORTS.’DAY’] subdirectory, prints out a report for the 
day of your choice, returns you to your login device and 
directory, then exits. 

Ask which daily report to print out 

INQUIRE DAY "Day to print a report” 


WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "Changing your default directory" 


Set your default to the correct subdirectory 
SET DEFAULT DISK1: [REPORTS.’DAY’ ] 


WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "Printing the ‘'’day’ report" 


Print out the report for the correct day 
PRINT ’DAY’ .RPT 
Return to your login device and directory 


WRITE SYSSOUTPUT "" 
WRITE SYSSOUTPUT "Changing back to your login directory" 


SET DEFAULT SYSSLOGIN 
EXIT 


Execution of REPORT3.COM: 


S$ @REPORT3 


Day to print report for: TUESDAY 


Changing your default directory 


Printing the TUESDAY report 


Job TUESDAY (queue SYSSPRINT, entry 47) started on WORKSTXAO 


Changing back to your login directory 
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* PASSING PARAMETERS TO COMMAND 
PROCEDURES 


Parameters 


¢ Parameters are the objects of DCL commands 
— Keywords 
— File specifications 
— Integer or string values 


- You can specify parameters for a command procedure at execution time 


Local Symbols P1 — P8 


- The system automatically provides eight local symbols....P.1.through.P8 


- These symbols are initially assigned null values 


Passing Parameter Values to a Command Procedure 


* If you specify parameters when you execute the command procedure, the system 
= pssigns the vanes you specity to the symbols Fla re. 
— Maintains the_null value if you do not specify a parameter 
- Syntax: 
“€” $ @command_procedure.com parameter_1 parameter_2... parameter_8 | 
a 
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Example 7-6: Passing Parameters to Command Procedures 








e 3 REPORT4 .COM 
Soa 
ae ; 
S$ ! This command procedure sets your default directory to the 
$ ! [REPORTS.’P1’] subdirectory, prints out a report for the day of 
S ! your choice, returns you to your login device and directory, 
Ss ! then exits. 
2 
$ WRITE SYSSOUTPUT "" 
Ss WRITE SYSSOUTPUT "Changing your default directory" 
Ss ! me 
S$ ! Set your default to the correct subdirectory fe = 
S ! , y ‘ ‘7 ‘ 2 ae a) 
$ SET DEFAULT DISK1:[REPORTS.’P1’] | wb ~ . a oS - _ oe 
$ WRITE SYSSOUTPUT "" ce es fy a er 
S WRITE SYSSOUTPUT "Printing the (PL) caberee Se - Oss, 
$s! : 4 a cat 
1a ee 
$ ! Print out the report for the correct day | Pe Fong 
§ PRINT P14 .RPT | ms 
5 ee 
S$ ! Return to your login device and directory 
$ ! 
S WRITE SYSSOUTPUT "" 
$ WRITE SYSSOUTPUT "Changing back to your login directory" 
oS 
$ SET DEFAULT SYSSLOGIN 
eR NTE ANY 
S EXIT 
Execution of REPORT. COM 
(8 GREPORT4 | TUESDAY _) LATE PR aae re ae 
_ Changing your default vest so 
Printing the TUESDAY report 
Job TUESDAY (queue SYSSPRINT, entry 47) started on WORKSTXAO 
Changing back to your login directory 
“AAM | 
ie i 
«4 pt - ry + 
- : # atv ae 
26> ne oe ee i | 
12 i § h ™ saa Neg E 
- mr 
4 fn = a : ra Poe nes Ap % 
| , faery Af yf my, a 4 
A ital 
CHM PLSD + 
(ut of fowse THIS §S LESS USeeved) 
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CONTROLLING PROGRAM FLOW 


- Normally commands are executed sequentially in a command procedure 


¢ Control flow statements allow you to alter the order of execution 


. Control flow commands include 


— The IF command 


— The GOTO command -4Ltows For 
Cd tL Levee 


Cate 


The IF Command 


° Formats: 


S$ IF conditional expression THEN command 


$ IF conditional expression 
$ THEN command 

$ command 

S$ ENDIF 


$ IF conditional expression 
$ THEN command 

$ command 

S ELSE command 

S ENDIF 
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*- Accepts multiple statements for execution when the condition is true 


- The conditional expression is tested 


— If the condition is met, the command(s) following THEN are performed 


— If the condition is not met, the next DCL command in sequence is performed or an 


optional ELSE statement can be performed 


¢ The command(s) following THEN or ELSE can be 


— A GOTO command 


— Another DCL command 
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THE IF-THEN-—ELSE COMMAND 


- The optional ELSE parameter provides command(s) to be performed when the IF condition 
is false 


* The command(s) following ELSE can be any valid DCL command(s) 


¢ Syntax: $ IF conditional expression THEN command ELSE command(s) 
Restrictions to IF~-THEN—ELSE Command 


- Acommand block started by a THEN statement must be terminated by an ENDIF statement 
+ A THEN statement must be the first executable statement following an IF statement 

¢ THEN, ELSE, and ENDIF statements cannot be abbreviated to fewer than four characters 
* Do not specify labels on a THEN or ELSE statement 


e Labels are legal on an ENDIF statement 


memaihiatel s meennarmnenirteniim aa erica 


ne ens en 


« Command procedures may branch within the current command block, but branching into 
the middle of another command block is not recommended 


The GOTO Command 


© Syntax: 
$ GOTO label 
* No conditional testing is performed 


¢« Control is transferred to the specified label 
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Table 7-6: Relational Operators Used in Expressions 


Operator Description 

String Operators 

.EQS. Tests if two character strings are equal. 

.GES. Tests if the first string is greater than or equal to the second 
string (collating sequence). 

.GTS. Tests if the first string is greater than the second string. 

.LES. Tests if the first string is less than or equal to the second string. 

.LTS. Tests if the first string is less than the second string. 

.NES. Tests if the two strings are not equal. 

Numeric Operators 

EQ. Tests if two numbers are equal. 

JGE. Tests if the first number is greater than or equal to the second 
number. 7 

.GT. Tests if the first number is greater than the second number. 

sakes | Tests if the first number is less than or equal to the second 
number. 

el | Tests if the first number is less than the second number. 

.NE. Tests if two numbers are not equal. 

Logical Operators 

NOT. Tests for the opposite of a given condition. 

AND. Tests if both of two conditions. are met. 

OR. Tests if one of a group of conditions is met. 
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Example 7~7: Controlling Program Flow 


S$! 
$! 
S$! 
$! 
$! 
oh 
S$! 
$! 
Se 
$! 
$! 
S$! 
S 
$! 
$ 
$ 
$ 
$ 
S 
$} 
$ 
$ 
$! 
$! 
$! 
$ 
$! 
$! 
$! 
$! 
$} 
$! 
$ 


a 


' §! 


i og 


} 
4 
y 


a 
$ 


$! 
$ 
$ 
$! 


DEL DIR.COM 


This command procedure deletes previously emptied 
directories. It assumes that the directory to be 
deleted is owned by the procedure’s user. 


Check to see if the user entered the directory name. 
If yes, skip to the confirmation question. 
If no, display a message and ask for the directory name 


IF Pl .NES. "" THEN GOTO CONFIRM 


WRITE SYSSOUTPUT " " 

WRITE SYSSOUTPUT "This procedure deletes an emptied directory" 
WRITE SYSSOUTPUT "The .DIR file extension is assumed." 

WRITE SYSSOUTPUT " " 

INQUIRE Pl "Directory name" 


CONFIRM: 
INQUIRE P2 "Confirm, please (Y/N)" 


If the user answers ’No’, abandon this procedure. 
IF .NOT. P2 THEN GOTO NODELETE 

Reset the directory protection so that the owner 
can delete it, delete the directory and display 
the system message. Note that the precedure 


substitutes the directory name for the symbol Pl. 


SET PROTECTION=(O:RWED) ‘P11’ .DIR;* 


DELETE/LOG 'P1’ .DIR;* 
GOTO END » 


NODELETE: 


WRITE SYSSOUTPUT " " 
WRITE SYSSOUTPUT "Directory file not deleted." 


EXIT 
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Execution of DEL_DIR.COM: 
Example 7-7: Controlling Program Flow (Cont) 


Confirm, please (Y/N): Y 


$ @DEL_DIR TEST 
2DELETE-I-FILDEL, DISK: [DENISE]TEST.DIR;1 deleted (3 blocks) 


Nn 


Second execution: 


$ @DEL DIR 


This procedure deletes an emptied directory 
The .DIR file extension is assumed. 


Directory name: TEST2 

Confirm, please (Y/N): Y 

*DELETE-I-FILDEL, DISK: [DENISE] TEST2.DIR;1 deleted (3 blocks) 
S 


Third execution: 


$ @DEL DIR 


This procedure deletes an emptied directory 
The .DIR file extension is assumed. 


Directory name: TEST3 
Confirm, please (Y/N): N 


Directory file not deleted. 
$ 
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LEXICAL FUNCTIONS 


> Lexical functions provide information about an item or list of items __ 


- The information is returned.in.a symbol that can then be used.in.a.command procedure 


* Lexical functions return integer or character strings, depending.on the lexical function 


shatter NF RRA KAP AA PN tr natenied 





Format and Syntax 


¢ All lexical functions begin with F$, followed by the function name 
WHO = FSPROCESS() 
e All lexical functions require parentheses, even with null arguments 
i a arr TER Itty ELON EM tee Sead tee ae con PCT IN eR UE ORT ET PTH GEA TELE, nate 
— Integer or character strings: 
WHAT = FSEXTRACT (0,3, "MAILMAN") 


— Symbols: 


t 
2 
2 

i 
i 
i 


HOWLONG = FSLENGTH (P1) 


_— Keywords: 


WHERE = FSTRNLNM("SYSDISK") 


— Null arguments: 


WHEN = FSTIME() 





¢ Multiple arguments are separated by commas 
¢ Optional arguments, when omitted, are indicated by commas 
¢ Table 7-7 describes some lexical functions 


- Examples 7-8 and 7-9 demonstrate the use of some lexical functions 


7-28 WRITING COMMAND PROCEDURES 


~\ Table 7-7: Frequentiy Used Lexical Functions 


Lexical Function 
FSTIME() 
FSPROCESS() 
FEMODE() 


FSELENGTH(string) 
FELOCATE(substring, string) 
FSEXTRACT(offset,number, string) 


- FECVTIME ([input—time], [format], [field]) 


FEGETSY1(item,[node]) 
FSENVIRONMENT(item) 


FSGETQUI() 


Description 


Returns the current date and time string. 
Returns the current process name. 


Returns a character_string indicating the mode 
in which a process is running (INTERACTIVE, 
BATCH, or. OTHER). 


Returns the length of a string. 


Locates the substring in the string and returns the 
offset position. 


Extracts a substring from a character string ex— 
pression. 


Returns information about absolute, combination, 
or delta time strings. 


Invokes the $GETSY! System Service to return — 
status and identification information about your 
system, or a node in your cluster. 


Returns information about the DCL command en-— 
vironment (PRIVILEGES, DEVICE, and DIREC- 
TORY). 


Returns information regarding queues and the 
batch and print jobs currently in those queues. 
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Example 7-8: Using Lexical Functions with the INFO.COM Command Procedure 


INFO.COM 


This command procedure allows the user to leave a message 
on the terminal screen, along with information about the 
process. The time when the message was left is also displayed. 


Use lexical functions to determine the current time 

and day of the week 

TIME = FSTIME() 

CURR_TIME = FSEXTRACT (12,5, TIME) 

WEEKDAY = FSCVTIME (TIME,, "WEEKDAY") ! Returns Monday, Tuesday, etc. 


Clear the screen using the TYPE/PAGE NL: command 
TYPE/PAGE NL: 


Display process name, the time, and the day of the week. 
NAME= FSPROCESS () 

WRITE SYSSOUTPUT NAME 

WRITE SYSSOUTPUT " " 

WRITE SYSSOUTPUT "IT IS '’CURR_TIME’ ON A ’’WEEKDAY’ " 
WRITE SYSSOUTPUT " " 


Leave the procedure 


END: 
EXIT 


Execution of INFO.COM 


S$ @INFO 
DENISE 


IT IS 12:23 ON A Monday 
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Example 7~9: Using Lexical Functions with the PRINT.COM Command Procedure 


' PRINT.COM 


This procedure allows you to print multiple copies 
of any file you choose. It will ask for the file 
name and number of copies if the information is 
not supplied on the command line. The procedure 
will not let the user print a binary file. 


ee ee ee 


NAME FILE: 
IF Pl .EQS. "" THEN INQUIRE Pl "File to be printed" 


LENGTH=FSLENGTH (P1) 
IF LENGTH .EQ. 0 THEN GOTO NAME FILE 


PERIOD=FSLOCATE (".",P1) 
FNAME=FSEXTRACT (0, PERIOD, P1) 


! Check to see if user entered file type. If yes, separate 
! filename from file type. If no, assign .LIS type to the file 
IF LENGTH .EQ. PERIOD 
THEN FTYPE=".LIS" 
ELSE FTYPE=FSEXTRACT (PERIOD, LENGTH-PERIOD, P1) 
ENDIF 


! Check to see if user entered a binary file type. If yes, exit. 
! If no, see how many copies they want. 
a 


IF FTYPE .EQS. ".OBU" .OR. FIYPE .EQS. ".EXE" 


THEN WRITE SYSSOUTPUT "YOU CAN’T PRINT A /'’FTYPE’ FILE" 
EXIT 
ENDIF 
ve. TL oon j 
NUMBER_COPIES: cake © ae ee 
IF P2 .EQS. "" THEN INQUIRE/NOPUNCTUATION P2 "HOW MANY COPIES DO YOU WANT? " 


IF NUMBER .LE. 0 THEN GOTO NUMBER COPIES 


! Print the correct number of copies then exit the procedure 
! 


PRINT/COPIES=’ P2! ‘FNAME’ / FTYPE’ 


DMNUOMN NO MND HUN MN UVOMNWU UO UN UHH MMN NHN UON DMN UHNMUHHNOHUNOHMNHMH MN YH 


EXIT 
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SUMMARY 


- A Command Procedure is a file containing DCL command strings 
« These command strings are made up of | 
— DCL command verbs 
— Command parameters 
— Qualifiers 
¢ Command procedures frequently make use of 
— DCL symbols - command synonyms, numeric and string variables 
— Control flow commands —- IF, GOTO 
— Lexical functions 
¢ You can perform terminal input and output functions using 
— INQUIRE 
— READ SYS$COMMAND 
— WRITE SYSSOUTPUT 
— TYPE SYS$INPUT 
o Control flow commands allow you to alter the order of command execution 


— IF—~THEN or IF-THEN—ELSE - transfers control based on the results of conditional ex— 
pressions | 


— GOTO —- unconditionally transfers control 


¢« You can pass numeric and string information to the command procedure using the local 
symbols P1 — P8 associated with every command procedure 


¢ Lexical functions allow you to gather and use system and process information in command 
procedures 
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MODULE 8 | 
USING DISK AND TAPE VOLUMES 


USING DISK AND TAPE VOLUMES 8&1 


INTRODUCTION 


In addition to your default disk device, your system includes a number of tape devices and disks. 
You can use one of these devices whenever you wish to store copies of files on a private volume. 
Private volumes can be created on disks or tapes. Private volumes are used to preserve files, 
transfer files from one system to another, and provide more space on a system (system quotas). 


OBJECTIVES 


This module introduces the steps and commands required to create and use private volumes. 


RESOURCES 


¢ VMS DCL Dictionary 
¢ VMS Backup Utility Manual 
¢ VMS Mount Utility Manual 
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Figure 81: Volume Manipulation Commands 





$ volume manipulation command 
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CREATING PRIVATE VOLUMES: THE COMMAND 
SEQUENCE 


The following table lists DCL commands used to create and access disk and tape volumes. 


Table 8-1: Commands for Creating and Accessing Private Disk and Tape Volumes 


Operation Comments 


Allocate a device Allocates a device for exclusive use. The logical name DISK 
) is placed in your process logical name table and assigned the 
name of the allocated device. Other users are unable to access 

the device. | 


$ ALLOCATE device [logical-name] 
S$ ALLOCATE DM DISK 


Initialize a tape or disk Builds the appropriate disk structure on the volume. Establishes 
volume ownership and protection. Usually used for new vol— 
umes. 


$ INITIALIZE device label 
$ INITIALIZE DMA2: TEST DISK 


Make the volume accessible You can access the device as well as manipulating files on the 
to you | volume. Logical names are often used. 


$ MOUNT device label [logical-name] 
$ MOUNT DMA2: TEST DISK DISK 


Prohibit further access to the Closes all open files. Dismounts and unloads the volume. 
volume Deletes the logical name assignment made by the MOUNT com- 
mand. 


$ DISMOUNT device 
$ DISMOUNT DMA2: 


Deallocate a device Frees the device for use by other users. Does not delete a 
logical name assigned by the ALLOCATE command. 


$ DEALLOCATE device 
S$ DEALLOCATE DMA2: 
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MOUNTING A VOLUME WITH AN UNKNOWN LABEL 


¢ MOUNT command format: 


$ MOUNT/OVERRIDE=IDENTIFICATION device-name volume-label logical-name 


¢ Requirements are: 
— Volume ownership or 


— VOLPRO privilege 


Example 8-1: Mounting a Disk with an Unknown Label 


S MOUNT/OVERRIDE=IDENTIFICATION DM: UNKNOWN MYDISK 


*S‘MOUNT-I-MOUNTED, MYVOL mounted on DMAO: 


S$ SHOW DEVICE/FULL MYDISK 


Disk DMAO:, device type RKO7, is online, 


mounted, error logging enabled. 


Error count 33 
Owner process "SMITH" 
Owner process ID OO0000A2 
Reference count 2 
Volume label . "MYVOL" 
Cluster size 3 
Free blocks 53703: = 
Extend quantity 5 
Mount status Process 
File ID cache size 64 
Quota cache size 0 


Write-thru caching enabled 


Volume is subject to mount verification, 


Mount count 
Cache name 


allocated, deallocate on dismount, 


Operations completed 3891 

[100,0]} 

S:RWED, O:RWED, G: RWED, W: RWED 

Default buffer size 512 

Relative volume no. 0 
Transaction count Mes 

Maximum files allowed 6723 

1 

“DRAO : XQPCACHE" 

Extent cache size 64 


file high-water marking. 
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THE BACKUP UTILITY 


The Backup utility performs the following operations 
« Copies disk files 
¢ Saves disk files toa BACKUP save set 


- Restores files to disk from a BACKUP save set 


Format: 

$ BACKUP/qualifier input-specifier output~specifier 

¢ Tapes must be mounted using the /FOREIGN qualifier to the MOUNT command 
¢ Files specified are placed in a save set 

e A Save set can exist on a tape or disk 


e When used with tape volumes, BACKUP can create and gain access to save sets only 


SAVE-SET SPECIFICATIONS 


A save-—set specification is a label fora BACKUP save set. The Backup utility creates and labels 
a Save set and then writes files to the save set. A save-set specification can include: 


e A node name 

° A device specification 

° <A directory 

* A Save-—set name 

¢ A period (the mandatory delimiter after the save—set name) 


« A Save-set type (usually BCK or SAV) 
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Example 8-2 demonsirates how to create a save set on a tape. 
Example 8-3 shows how to transfer files from a disk to tape. 


Example 8—~ illustrates how to restore files from a tape to a disk. 


Example 8-2: Creating Save Sets on a Tape 


SET DEFAULT [SMITH] 

ALLOCATE MTAO: 

INITIALIZE MTAO: SOURCE 

MOUNT/FOREIGN MTAO: 

BACKUP/IGNORE=LABEL PROCESSING [...] MTAOQ:MY_ BACKUP .BCK 
DISMOUNT MTAO: 


nr Mm WNW HH DH DW DM 


DEALLOCATE MTAO: 


Example 8-3: Transferring Files to a Tape 


S$ ALLOCATE MUAO: 
*DCL-I-ALLOC, _BROWNYSMUAO: allocated 


S INITIALIZE MUAO: SOURCE 


$ MOUNT/FOREIGN MUAO: 
SMOUNT-I-MOUNTED, SOURCE mounted on _BROWNYSMUAO: 


$ DIRECTORY [...]. 

‘Directory DISK: [SMITH] 

EVE.INIT? 2 FORTRAN.DIR;1 INSERT .FYI;6 

JOE EVE.TPUSSECTION;1 LOGIN .COM; 21 PASCAL.DIR;1 
Total of 6 files. 


Directory DISK: [SMITH.FORTRAN] 
EXAMPLES .FOR;1 FILES.FOR;1 TEXT.FOR;1 
Total of 3 files. 


Directory DISK: [SMITH.PASCAL] 
EXAMPLES.PAS;1 FILES.PAS;1 | TEXT.PAS;1 
Total of 3 files. 


Grand total of 3 directories, 12 files. 


In 


SET DEFAULT [.FORTRAN] 


an 


BACKUP/IGNORE=LABEL PROCESSING *.*;* MUAO:FOR.BCK 


in 


SET DEFAULT [SMITH. PASCAL] 
$ BACKUP/IGNORE=LABEL PROCESSING *.*;* MUAO:PAS.BCK 
§ BACKUP/REWIND/LIST MUAO:PAS.BCK 
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Example 8-3: Transferring Files to a Tape (Cont) 


Listing of save set(s) 


Save set: PAS.BCK 

Written by: SMITH 

UIC: [000011,000051] 

Date: 25-JAN-1988 13:30:10.59 

Command: BACKUP/IGNORE=LABEL PROCESSING *.*;* MUAO:PAS.BCK 
Operating system: BACKUP version: V><0 

CPU ID register: 08000000 

Node name: BROWNY: : 

Written on: _BROWNYSMUAO : 

Block size: 8192 

Group size: 10 

Buffer count: 3 

{SMITH.PASCAL] EXAMPLES .PAS;1 2 21-JAN-1988 15:17 
[SMITH.PASCAL] FILES .PAS;1 2 21-JAN-1988 15:18 
{[SMITH.PASCAL] TEXT.PAS;1 2 21-JAN-1988 15:17 


Total of 3 files, 6 blocks 
End of save set 


$ BACKUP/REWIND/LIST MUAO:FOR.BCK 
Listing of save set(s) 


Save set: FOR.BCK 

Written by: SMITH 

ULC: {000011,000051] 

Date: 25~JAN-1988 13:31:37.89 

Command: BACKUP/IGNORE=LABEL PROCESSING *,*-* MUAO:FOR.BCK 
Operating system: VAX/VMS version X5.0 

BACKUP version: V5.0 

CPU ID register: 08000000 

Node name: BROWNY: : 

Written on: _BROWNYSMUAO : 

Block size: 8192 

Group size: 10 

Buffer count: 3 | 

{SMITH.FORTRAN]EXAMPLES.FOR;1 2 21-JAN-1988 15:16 
{[SMITH.FORTRAN] FILES.FOR;1 2 21-JAN-1988 15:16 


[SMITH. FORTRAN] TEXT .FOR; 1 | | 2 21-JAN-1988 15:16 


Total of 3 files, 6 blocks 
End of save set 


$ DISMOUNT MUAO: 
S$ DEALLOCATE MUAO: 
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Example 8-4: Restoring Files from a Tape to a Directory 


$ MOUNT/FOREIGN MUAO: 
*xMOUNT-I-MOUNTED, SOURCE mounted on _BROWNYSMUAO: 


S$ DIRECTORY [SMITH. FORTRAN ] 
*sDIRECT-W-NOFILES, no files found 


S$ DIRECTORY [SMITH.PASCAL]} 
*DIRECT-W-NOFILES, no files found 


$ SET DEFAULT [SMITH.FORTRAN] 

$ BACKUP/IGNORE=LABEL PROCESSING MUAO:FOR.BCK *.*;* 
S$ DIRECTORY 

Directory DISK: [SMITH.FORTRAN] 

EXAMPLES .FOR;1 FILES.FOR; 1 TEXT.FOR;1 
Total of 3 files. 

S$ SET DEFAULT [SMITH.PASCAL] 

$ BACKUP/REWIND/IGNORE=LABEL PROCESSING MUAO:PAS.BCK *.*;* 
$ DIRECTORY 

Directory DISK: [SMITH.PASCAL] 

EXAMPLES .PAS;1 FILES.PAS;1 TEXT.PAS; 1 
Total of 3 files. 
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SUMMARY 


Creating Private Volumes: The Command Sequence 


The following commands are used to create and access disk and tape volumes. 


Operation Comments | 

Allocating a Device Allocates a device for exclusive use. 

$ ALLOCATE device [logical-name] 

Initialize a tape or disk Establishes volume ownership and protection. 


$ INITIALIZE device label 


Make the volume accessible You can access the device as well as manipulating files on the 
to you volume. 


$ MOUNT device label [logical-name] 


Prohibit further access to the Closes all open files. Dismounts and unloads the volume. 
volume 


$ DISMOUNT device 

Deallocating a device Frees the device for use by other users. 
$ DEALLOCATE device 

The Backup Utility 

The Backup utility performs the following operations: 

¢ Copies disk files 

¢ Saves disk files toa BACKUP save set 


¢ Restores files to disk from a BACKUP save set 


Format: 

$ BACKUP/qualifier input-specifier output—specifier 

* Tapes must be mounted using the /FOREIGN qualifier to the MOUNT command. 
* Files specified are placed in a save set, which can be on tape or disk. 


+ When used with tape volumes, BACKUP can create and gain access to save sets only. 
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MODULE 9 
SUBMITTING BATCH AND PRINT JOBS 


SUBMITTING BATCH AND PRINT JOBS 9-1 


INTRODUCTION 


The PRINT command allows you to obtain a hardcopy version of a file. Usually your print job 
must wait in an orderly list of print requests called a queue. The system uses factors such as the 
priority and size of your job to determine how long your job waits before printing. This does not 
affect your terminal session because as soon as you issue the PRINT command your terminal 
is freed up so you can do other jobs. Commands are provided so you can check on your job's 
progress in the queue and determine when it has completed. 


The VMS system provides a similar facility for queuing command procedures for execution. Until 
now, you have run command procedures interactively. They process as though you were typing 
in each command. However, you can create a batch process to execute a command procedure 
independently of your interactive process. The SUBMIT command allows you to do this. The 
VMS system also determines when sufficient system resources are available for processing a 
job from the batch queue, and begins to process one or more jobs from that queue. You do not 
need to be logged in for your batch job to execute. 


This module discusses the PRINT and SUBMIT commands and their qualifiers. These com- 


mands have different functions. However, they have several concepts and qualifiers in com- 
mon. 
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OBJECTIVES 


To effectively handle batch and print jobs, you should be able to perform the following operations: 
* Print one or more files. 

¢ Submit command procedures to be executed as a batch job. 

¢- Display and modify the status or characteristics of print and batch jobs. 

« Delay processing of batch or print jobs. 


¢ Delete a batch or print job from its queue. 
RESOURCES 


¢ VMS DCL Dictionary 


¢ Guide to Using VMS 
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PRINTING A FILE 


PRINT Command in DCL 


- The PRINT command uses a default file type of LIS 


e Job numbers indicate the order in the queue ~sye.07 ons VO paca on 
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* The print queue, named SYSSPRINT, handles print requests by default ae 


¢ The first available printer prints the job 


Example 9-1: Issuing the PRINT Command 


S$ PRINT MYFILE.TXT 
Job MYFILE (queue SYSSPRINT, entry 456) started on LPAO 
$ 
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Types of Print Queues 


> Execution queue 
— Associated with each printer 
—- Usually has the same name as the physical device name 
— Responsible for the actual printing of jobs 
¢ Generic queue 
~-— Responsible for the distribution of print jobs to printers with similar characteristics 
—— Holds jobs until the first available execution queue is free 


* To specify a particular queue, use the /QUEUE qualifier 
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Figure 9-1: Execution and Generic Print Queues 
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Qualifiers for the PRINT Command 


¢ Number of copies 
/COPIES 
— Defaults to one copy 
— Number of copies can be 1 — 255 
¢ Spacing of the print job 
/[NO]SPACE 
— For single spacing use /[NO]SPACE (Default) 
— For double spacing use /SPACE 
¢« Whether the system notifies you when the job is completed or aborted 
/NOTIFY 
— /{NO]NOTIFY is the default 
¢ Number of times your complete job is printed 
/JOB_COUNT 
— Avalue from 1 to 255 
— Default is one printing 
e Number of pages to print 
/PAGES=([lowlim,],uplim) 
= lowlim = First page to be printed 
— uplim = Last page to be printed 
¢ Time job is released to print - 
/AFTER=time 
— Default is current date and time 


— Time can be specified as absolute time, or a combination of absolute and delta time 
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Table 9—1: Printing Jobs with Different Characteristics 


Operation Example 


Requests that two copies of  $ PRINT/COPIES=2 MEMO.TXT 
the file MEMO.TXT be printed. 


Requests that two copies of $ PRINT MEMO.TXT/COPIES=2,MYFILE.TXT/COPIES=3 
the file MEMO.TXT and three 

copies of the file MYFILE. TXT 

be printed. . 

Requests three printings of $ PRINT/JOB_COUNT=3 MEMO.TXT 

the file MEMO.TXT. 


Requests a double-spaced $ PRINT MEMO.TXT/ SPACE 
copy of the file MEMO. TXT. 


Prints pages 6 through 8. $ PRINT/PAGES= (6,8) MYFILE.TXT 


Prints page 6 through the ends ¢ PRINT/PAGES=(6,"") MYFILE.TXT 
of file. 


Releases the file MEMO.TXT = $ PRINT/AFTER=18:00 MYFILE.TXT 
for printing at 6 p.m. on the 
current date. 
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OBTAINING STATUS OF QUEUES 


° Format: 


$ SHOW QUEUE/qualifier [queue—name] 


¢ Example: 


$ SHOW QUEUE/ALL ENTRIES SYSSPRINT 


Terminal queue SYSSPRINT, on BROWNY::SPRINTER, mounted form DEFAULT 


Jobname Username Entry Blocks Status 

MYF ILE SMITH 45 60 Printing 

LICENSES SMITH 48 78 Pending 

TAGS SMITH 49 88 Pending 

OFFICERS SMITH 52 90 Pending 
* Format: 


$ SHOW QUEUE/BY_ JOB STATUS[=keyword[,...]] [queue—name] 


Keywords for the BY_JOB_ STATUS qualifier include: 


EXECUTING (Displays executing jobs) 

HOLDING (Displays jobs on hold) 

PENDING (Displays pending jobs) 

RETAINED (Displays jobs retained in queue after execution) 


TIMED_RELEASE (Displays jobs on hold until a specified time) 


e Example: 


9— 10 


$ SHOW QUEUE/BY JOB STATUS=TIMED RELEASE SYSSPRINT 


Terminal queue SYSSPRINT, on BROWNY::SPRINTER, mounted form DEFAULT 
Jcbname Username Entry Blocks Status 


MYFILE SMITH 96 1 Holding until 2-DEC-1987 15:00 
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Format: 

$ SHOW QUEUE/DEVICE=[keywordj....]] [queue—name] 
Keywords for /DEVICE qualifier include: 

— PRINTER (Displays all print queues) 

— SERVER (Displays all server queues) 

_— TERMINAL (Displays all terminal queues) 


Example: 


S$ SHOW QUEUE/DEVICE=SERVER 
Server queue BROWNYSNARROW, stopped, on BROWNY::, mounted form DEFAULT 


Jobname Username Entry Blocks Status 


~~ oe = a a a oe = an an ae oe ew oP om -_ = oe eo = an a2 oe oe oe — = cur a a ae 


MYF ILE SMITH 97 1 Holding until 2-DEC-1987 15:00 
Server queue BROWNYSWIDE, stopped, on BROWNY::, mounted form DEFAULT 


Format: 
$ SHOW ENTRY [entry—number] /[qualifier] 


Example: 


S$ SHOW ENTRY 96 


Jobname Username Entry Blocks Status 


MYFILE SMITH 96 lL Holding until 2-DEC-1987 15:00 
On terminal queue SYSSPRINT 


Example: 


$ SHOW ENTRY 96/FULL 


Jobname Username Entry Blocks Status 


MYFILE SMITH 96 1 Holding until 2-DEC-1987 15:00 
On terminal queue SYSSPRINT 
Submitted 2-DEC-1987 09:18 /FORM=DEFAULT /PRIORITY=100 
_DISK: [SMITH] MYFILE .TXT; 1 
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Example 9-2: Queue Status Display Corresponding to Figure 9—1 


S$ SHOW QUEUVE/DEVICE/ALL ENTRIES 


Printer queue LPAO 


—_ os aw am om a = 


MYFILE . TXT 


Printer queue 


USELESS .MEM 


Printer queue 


SCHEDULE 
PAYROLL 
SPREAD 


FILE .LOG 
TYPE .COM 
CHECK 


Username 


LP BO 


LPCO 


ANDERSON 


Blocks 
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Status 


Printing at block 6 


Status 


Printing at block 34 


Status 

Printing at block 88 
Pending 

Pending 


Status 

Pending 
Pending 
Pending 


Queue Status List 


Example 9-3: Full Format Queue Status Display 
S$ SHOW QUEUE/DEVICES/FULL/ALL ENTRIES 


Terminal queue COMP, on SUPER::SUPERSTTAZ2:, mounted form DEFAULT 
/BASE PRIORITY=4 /DEFAULT= (FEED,FORM=DEFAULT) Lowercase 
/OWNER=(GROUP1,SYSTEM] /PROTECTION=(S:E,0:D,G:R,W:W) 


Printer queue LNO1, on SUPER::SUPERSLPAO:, mounted form DEFAULT 
/BASE PRIORITY=4 /DEFAULT= (FEED, FORM=DEFAULT) 
/LIBRARY=SYSDEVCTL_LNO1 Lowercase /OWNER=[GROUP1, SYSTEM] 
/PROTECTION=(S:E,0:D,G:R,W:W) /SEPARATE= (FLAG, RESET=(ANSISRESET) ) 


Server queue NMSQUEO1], on SUPER::, mounted form DEFAULT 

/BASE PRIORITY=4 /DEFAULT= (FEED, FORM=DEFAULT) 

/OWNER=[GROUP1,SYSTEM] /PROCESSOR=NMSDAEMON /PROTECTION=(S:E,0:D,G:R,W:R) 
/RETAIN=ERROR 


Generic printer queue NMSQUEUE 
/GENERIC= (NMSQUEG1,NMSQUEO2) /OWNER=[GROUP1, SYSTEM] 
/PROTECTION=(S:E,0:D,G:R,W:R) /RETAIN=ERROR 


Jobname Username Entry Blocks Status 


NMATL SMITH 1630 146 Holding until 24-NOV-1987 11:26 
Submitted 24-NOV-1987 11:16 /PRIORITY=100 
_S1SDUAO: [SYSCOMMON .NMAIL] NMAIL$1987112217065820 .WRK;1 
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Modifying a Print Job Already in the Queue 


- Can change characteristics of your print job if it is not currently printing 
«+ Can move your job to another queue 
« Use the SET ENTRY command 


¢ See the following table for examples 


Table 9~2: Modifying Print Jobs in a Queue 


Command Comments 

$ SET ENTRY 100/COPIES=5 Changing the number of copies to five. 

$ SET ENTRY 80/RELEASE Releasing a job that was previously held. 
$ SET ENTRY 95/REQUEUE=FASTJOBS Moving a print job to another printer. 


9-14 SUBMITTING BATCH AND PRINT JOBS 


Deleting a Print Job 


* Can delete a print job while it is printing or while it is pending in a queue 


« May need to do this if you accidentally print a file with non-ASCII characters, such as an 
EXE or OBJ file : 


- Use the DELETE/ENTRY command 


* Example: 


$ DELETE/ENTRY=120 FASTJOBS 


SUBMITTING BATCH AND PRINT JOBS 9-15 


SUBMITTING A BATCH JOB 


DCL SUBMIT Command 


* The SUBMIT command uses a default file type of COM unless another file type is specified 
¢« Each job in the queue. consists of a command procedure 

* Job numbers indicate the order in the queue | 

¢ SYS$BATCH is the default system batch queue 


¢ The VMS system creates a batch process to execute the command procedure 


Example 9—4: Issuing the SUBMIT Command 


S$ SUBMIT ACTION.COM 
Job ACTION (queue SYSSBATCH, entry 136) pending 
$ 


9-16 SUBMITTING BATCH AND PRINT JOBS 


How a Batch Job Executes 


¢ Batch job’s relationship to job that submitted it 
— Runs independently 
— Uses same UAF characteristics 
— Executes same LOGIN.COM file 
— Uses same default device and directory for file access 
¢ Batch job’s SYS$OUTPUT assigned to batch log file 
— Created in login default directory 
— File name is the same as the name of batch command procedure 
— File type is LOG 
— File is printed, then deleted on completion of batch job 


¢ Logical name assignments for batch processes 


Table 9-3: Logical Name Definitions for Interactive and Batch Processes 


Definition When Definition When 

Interactive Process Batch Process 
Logical Name Begins to Execute Begins to Execute 
SYSSINPUT Interactive terminal Batch command file 
SYSS$OUTPUT Interactive terminal Batch log file 
SYSSCOMMAND | interactive terminal Batch command file 
SYSSERROR Interactive terminal Batch log file 
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Writing a Batch Command Procedure 


> Two ways to run a command procedure 
— Interactive 
— Batch 
* For command procedures running in batch, consider 
— The system's login command procedure is executed 
— Your login command procedure is executed 
Use the FSMODE() lexical function 


Bypass symbol definitions (not used in command procedures) 


Bypass commands that require a terminal, such as 


INQUIRE 
SET TERMINAL 


¢ By default, severe errors terminate batch job execution 
* The batch process’s default directory is the one specified as SYS$LOGIN 


¢ Verification is on in batch process by default 
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Qualifiers for the SUBMIT Command 


The SUBMIT command: 


The /QUEUE qualifier overrides the default system queue. — 


The /PARAMETERS qualifier passes parameters to the command procedure. 


The /LOGFILE qualifier renames the iog file. The default is the command file name with a 
file type of LOG. 


The /PRINTER qualifier redirects where the log file is printed. The default queue is 
SYS$PRINT. 


The /KEEP qualifier retains a copy of your log file in your directory. The default action is to 
print the log file and then delete it. 


The /AFTER qualifier delays the execution of the job until a later time. The default is to 
place the job in the queue immediately. 


The /NOTIFY qualifier notifies you when the i completes or aborts. The default is /NONO- 
TIFY. 


Refer to Table 9-4 for examples. 
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Table 9-4: Submitting Batch Jobs 


Operation 


Submitting a job with no parameters 


S$ SUBMIT ACTION 


Submitting a job to a specified queue 


$ SUBMIT/QUEUE=SLOWBATCH ACTION 


Submitting a job after a specified 
time 


S$ SUBMIT/AFTER=19:00 MYFILE.TXT 
Submitting a job that requires pa— 
rameters 

$ SUBMIT/PARAMETERS=(3, SUM) MATH 
Changing the log file name 


$ SUBMIT/LOGFILE=WENDY MYFILE 
Keeping the log file 


$ SUBMIT/KEEP MYFILE 


Comments 


The SUBMIT command uses a default file type of COM. 
The file submitted is ACTION.COM in this example. 


By default, the system batch queue SYS$BATCH is 
used. 


The file MYFILE.TXT will be held until the specified time 
(19:00) after which it will be processed. 


Up to eight parameters may be specified using symbols 
P1—P8. The symbols are local to the specified command 
procedures. P1 is 3 and P2 is SUM. 


The log file is called WENDY.LOG instead of MYFILE.LOG. 


The log file is queued to printer LPBO instead of SYS$PRINT. 


The log file is printed and retained in the user’s login 
directory. 


9— 20 SUBMITTING BATCH AND PRINT JOBS 


Example 9-5: Sample Batch Run of COUNT1.COM 


o TYPE “COUNT 1:..COM 

$!  COUNT1.COM 

$s! 

S$ SHOW TIME 

$ SHOW LOGICAL/PROCESS/JOB 
5 EXIT 


S$ SUBMIT COUNT1.COM 
Job COUNT1 (queue SYSSBATCH, entry 366) started on SYSSBATCH 
$ 


Output from the system’s LOGIN procedure 


$! COUNT1.COM 
$! 
S$ SHOW TIME 
13-JAN-1988 09:31:22 
$ SHOW LOGICAL/PROCESS/JOB 


(LNMSPROCESS TABLE) 


“EVESINIT" = "SYSSLOGIN: EVE.INIT" 
"SYSSCOMMAND" = " BROWNYSRTAI1:" 
"SYSSDISK" = "BROWNYSDJAO:" 
"SYSSERROR" = "_ BROWNYSRTA1:" 
"SYSSINPUT" [super] = " BROWNYSDJAO:" 
"SYSSINPUT" [exec] = " BROWNYSRTAL:" 
"SYSSOUTPUT" [super] = " BROWNYSRTA1:" 
"SYSSOUTPUT" [exec] = " BROWNYSRTAI1:" 
ui haa vt = MRTAL . A 


(LNMSJOB_803E1730) 


"SYSSLOGIN" = "BROWNYSDJAO: [SMITH]" 
"SYSSLOGIN DEVICE" = "BROWNYSDJAO:" 
"SYSSREM ID" = "SMITH" 

"SYSSREM NODE" = "SUPER: :" 
"SYSS$SCRATCH" = "BROWNYSDJAO: [SMITH] " 
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OBTAINING STATUS OF BATCH QUEUES 


° Format: 


$ SHOW QUEUE/qualifier [queue—-name] 


Example 9-6: Full Format Queue Status Display 


S SHOW QUEUVE/BATCH/FULL/ALL_ENTRIES HARDY BATCH 


Batch queue HARDY SYSTEM, on HARDY:: 
/BASE PRIORITY=3 /JOB_LIMIT=4 /OWNER=[GROUP1, SYSTEM] 
/PROTECTION=(S:W, O:W,G, W) 


Jobname Username Entry Status 

MYF ILE SMITH 1388 Holding until 3-DEC-1987 18:00 
DRAFT SMITH 1425 Holding until 4-DEC-1987 01:00 
TEST JONES 1352 Holding until 7-DEC-1987 00:00 


Batch queue HARDY BATCH, on HARDY:: 
/BASE_PRIORITY=2 /JOB_LIMIT=3 /OWNER=[GROUP1, SYSTEM] 
/PROTECTION=(S:E,0:D,G:R,W:W) 
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Table 9-5: Displaying Batch Queue Status 


Operation Comments 


Displaying a list of batch jobs By default, the only jobs displayed other than your own are 
those currently executing. To display all jobs, add the qualifier 
/ALL_ENTRIES to the SHOW QUEUE command. For more job 
information, add the qualifier /FULL to either the SHOW QUEUE 
or SHOW ENTRY command. 


S$ SHOW QUEUE/BATCH 

$ SHOW QUEUE/BATCH/ALL ENTRIES 

$ SHOW QUEUE/BATCH/FULL 

$ SHOW QUEUE/BATCH/FULL/ALL_ ENTRIES 
$ SHOW ENTRY/BATCH 

$ SHOW ENTRY/BATCH/FULL 


Displaying a list of batch jobs In any SHOW QUEUE command, you can specify a queue 
on a particular queue name instead of /BATCH. You can also use the qualifiers /FULL 
and /ALL_ENTRIES. 


$ SHOW QUEVE FASTJOBS 
$ SHOW QUEUE/ALL_ ENTRIES FASTJOBS 
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Modifying a Batch Job Already in the Queue 


¢ Can change job characteristics if it is not currently executing 
° Can move a job to another queue 
¢ Privileges required to affect jobs 

— Queued by you—None 

— Queued by processes in your UIC group—GROUP 

-—— Queued by anyone—WORLD or OPER 


Table 9-6: Modifying a Batch Job 


Operation Comments 


Changing the charac- The entry number (or job number) parameter specifies the number of 
teristics of a job the job you want to change. In this example, the number of copies for 
entry number 100 is being changed to five. 


$ SET ENTRY 100/COPIES=5 


Moving a job to an-___— In this example, the job MYFILE.TXT (entry number 90) is being moved 
other queue from a printer using narrow paper to a printer using wide paper. 


$ SET ENTRY 90/REQUEUE=WIDE 
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DELETING A BATCH JOB 


* Can delete a batch job while it is executing or while it is pending in the queue 
+ Use the DELETE/ENTRY command 


¢ Example: 


S$ DELETE/ENTRY=120 WIDE 
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HANDLING BATCH AND PRINT JOBS 


Characteristics Common to Both Batch and Print Jobs 


The name used to identify the job | 

The VAX node on which the job is processed 

Whether the system displays the job number when the job is queued 
Whether the system notifies you when the job completes 


Whether the system deletes the log file after the job completes 


BATCH AND PRINT QUEUES ETIQUETTE 


The following suggestions are given to insure that the VMS system batch and print queues flow 
efficiently and smoothly, with no “time lags" or "backups." 


Check the size of your print jobs before submitting them. 
If feasible, submit large print or batch jobs after hours. 
Set up a file size limit (in blocks) over which a job should be submitted after hours. 


lf submitting a large job, verify that the paper supply is sufficient to handle that job, or have 
an operator check on the paper supply. 


Do not print files that are not compatable for the particular device. 


Pick up your completed job promptly. Do not allow your finished jobs to sit in the printer 
area endlessly. 


—"* 
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SUMMARY 


Printing a File 

> The PRINT command uses a default file type of LIS. 

* Job numbers indicate the order in the queue. 

* The print queue, named SYS$PRINT, handles print requests by default. 


¢ The first available printer prints the job. 


Submitting a Batch Job 

* The SUBMIT command uses a default file type COM unless another file type is specified. 
¢ Each job in the queue consists of a command procedure. 

¢ Job numbers indicate the order in the queue. 

¢ SYS$BATCH is the default system batch queue. 


¢ The VMS system creates a batch process to execute the command procedure. 


Writing a Batch Command Procedure 
* There are two ways to run a command procedure. 
| — Interactive 
— Batch 
7 By default, severe errors terminate batch job execution. 


« The batch process’s defauit directory is the one specified as SYS$LOGIN. 


Deleting a Batch or Print Job 
¢ Can delete a batch or print job while it is executing or while it is pending in the queue 


« Use the DELETE/ENTRY command 
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MODULE 10 
DEVELOPING PROGRAMS 
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. 


INTRODUCTION 


This module presents a general discussion of the steps in developing a program on a VMS 
system as well as an introduction to a sample program. 


It does not provide details regarding any of the programming languages, such as FORTRAN or 
PASCAL. 


Tools that significantly decrease the time spent developing VMS programs include: 
e« Interactive Text Editor (EDT) 

¢ Compilers 

¢ VAX MACRO Assembler 

e VMS Linker 

« VMS Librarian 

¢ VMS Symbolic Debugger 


¢ System-—Supplied Routines 


The editors, assembler and compilers, and linker are utilities that prepare source programs for 
execution. The VMS Symbolic Debugger detects logic errors in executable image files. 


The librarian enables you to store frequently used segments of code, such as procedures or 
functions, in specially indexed files called libraries. You can reference procedures or functions 
stored in a library with a program. The linker combines the code from the library with your source 
code to produce an executable image file. :; 


system libraries contain a large number of predefined routines that user programs (such as 
routines that manipulate strings or generate random numbers) can call. 


\ 
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OBJECTIVES 


Most of the programming languages available on a VMS system, invoive the following program 
development steps: 


¢« Creating a text file containing the source statements of the program 

¢« Compiling or assembling the text file to create a file containing object code 
¢ Linking the object file or files to produce a file containing executable code 
¢ Running the executable image produced from the linker 


¢ Debugging the program to correct errors 


RESOURCES 


For more detailed explanations of developing programs, refer to the following documents: 
¢ Guide to VMS Programming Resources 


e VMS DCL Dictionary 
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PROGRAM DEVELOPMENT ON A VMS SYSTEM 


A user must complete the following steps to develop a program: 

- Create a text file that contains the source statements of your program. 

¢ Compile or assemble the text file to produce a file containing object code. 
¢ Link the object file or files to produce an executable image file. 

¢ Run the executable code produced by the linker. 


¢« Debug the program to correct errors. 


Figure 10—1 illustrates the orderly flow of these five program development steps. 
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Figure 10-1: A Flow Diagram of the Five Major Programming Steps 
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Each of the five program development steps is discussed on the pages that follow. As you read 


each step, refer to Figure 10-2. 
Figure 10-2: The Four Program Development Commands 
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FORTRAN [/qualifier] GRADES 


LINK[/qualifier] GRADES 
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RUN[/qualifier}] GRADES 
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1. Create a text file that contains the source statements of your program. 


Name the source file using the file type that relates to the source code programming lan- 
guage. Below are the default file types for a number of languages. 


Table 10-1: Languages and Associated File Types 


Language File Type 
BASIC BAS 

C C 

COBOL COB 
FORTRAN FOR 
MACRO MAR 
PASCAL PAS 

PL/I PLi 


2. Compile or assemble the text file you created to produce a file containing object code. 


The compiler or assembler translates the source statements of each input file into object 
code, producing one or more object files of type OBJ. 


To compile or assembie the code, you must use the DCL command related to the language 
of the source code in the text file. The following are examples of compile and assemble 


commands. 

Language Compiler/Assembier Command 
BASIC $ BASIC file-specification 

C- $ CC file-specification 

COBOL $ COBOL file-specification 
FORTRAN $ FORTRAN file-specification 
MACRO $ MACRO file-specification 
PASCAL $ PASCAL file-specification 

PL $ PLI file-specification 
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Link the object file or files to produce an executable image. 


The linker searches personal and system libraries for external procedures and functions that 
it cannot find in the specified input files. 


To link the object file(s), invoke the VMS Linker with the DCL command LINK. You can 
specify the names of the files to be linked, such as object code files or modules from 
libraries, after the command. Separate names with commas. The linker assumes that the 
file type of input files is OBJ. 


The Linker’s file output contains executable code assigned the file type of EXE. 
Invoke the image activator to run the executable code produced by the Linker. 


To execute a program, enter the DCL command RUN followed by the name of a single 
executable image file. The RUN command assumes that the file type field of the input file 
specification is EXE. 


You should not attempt to execute a program without correcting compiler and linker errors 
first. 


Debug the program to correct errors. 
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THE VMS SYMBOLIC DEBUGGER UTILITY 


The VMS Symbolic Debugger simplifies the debugging job. Debug commands implement many 
of the same debugging techniques used on paper. | 


The VMS Symbolic Debugger allows you to observe and manipulate your program interactively 
as it executes. By issuing debugger commands at the terminal, you can: 


¢ Start, stop, and resume the execution of the program 

* Trace the execution path of the program 

*« Monitor selected locations, variables, or events 

* Examine and modify the contents of variables, or force events to occur 


- Test the effect of modifications without having to edit the source code, recompile, and, in 
some cases, relink. 


There are three ways to invoke the debugger: 
1. Include the debugger in the executable image. 
2. Halt the program and invoke the debugger with the DCL command DEBUG. 


3. Run the program with the debugger. - 


To use the Help facility of the Debugger, invoke the symbolic debugger and enter the HELP 
command. 


10-10 DEVELOPING PROGRAMS 


A SAMPLE PROGRAM - GRADES 


The GRADES program (written in FORTRAN), contains the names of students and their grade 
averages for a particular course. The program obtains the names and grades from you, com— 
putes the average of the grades, and outputs the results to the terminal and to a designated file, 
ENGLISH. DAT. 


Example 10-1: GRADES.FOR Source File 
PROGRAM GRADES 


CHARACTER STUDENT NAME*30, DONE*4 
REAL AVERAGE 


OPEN (UNIT=1, FILE=’English’, STATUS=’ New’ ) 


10 TYPE 20 

20 FORMAT (/'’ Student name? ’,$) 
ACCEPT 30, STUDENT NAME 

30 FORMAT (1A30) 


CALL COMPUTE (AVERAGE) 


TYPE 40,STUDENT NAME, AVERAGE 
WRITE (1,40) STUDENT NAME, AVERAGE 


40 FORMAT (/' Student: ’,A30,’Average: ',F10.1) 
TYPE 50 

50 FORMAT (/’ Are you done ? (Yes/No) ',$§) 
ACCEPT 60, DONE 

60 FORMAT (1A4) 


IF (DONE.NE.’Y’ .AND. DONE.NE.’y’) GOTO 10 


CLOSE (UNIT=1) 
END 


SUBROUTINE COMPUTE (AVERAGE) 


INTEGER ICOUNT 
REAL TOTAL, GRADE 


ICOUNT = 0 

TOTAL = 0 

10 TYPE 20 

20 FORMAT (' Input grade (or 0 to end input): ‘,$) 
ACCEPT 30, GRADE 

30 FORMAT (F10.0) 


IF (GRADE.NE.O) THEN 
ICOUNT = ICOUNT + 1 
TOTAL = TOTAL + GRADE 
GO TO 10 

ENDIF 


40 IF (ICOUNT.NE.O) AVERAGE = TOTAL/ICOUNT 


RETURN 
END 
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Execution of GRADES 


Example 2 depicts a sample run of the GRADES program. 


Example 10-2: Execution of GRADES 


$ FORTRAN GRADES 

$ LINK GRADES 

S$ RUN GRADES 

Student name? JOHN SMITH 

Input grade (or 0 to end input): 45 
Input grade (or 0 to end input): 80 
Input grade (or 0 to end input): 99 
Input grade (or 0 to end input): 0 


Student: JOHN SMITH Average: 74.7 
Are you done ? (Yes/No) N 


Student name? MARY HAGERTY 

Input grade (or 0 to end input): 82 
Input grade (or 0 to end input): 69 
Input grade (or 0 to end input): 94 
Input grade (or 0 to end input): 0 


Student: MARY HAGERTY Average: 81.7 
Are you done ? (Yes/No) N 


Student name? HOSIAH HOWER 

Input grade (or 0 to end input): 90 
Input grade (or 0 to end input): 78 
Input grade (or 0 to end input): 81 
e) 


input grade (or to end input): 0 

Student: HOSIAH HOWER Average: 83.0 
Are you done ? (Yes/No) Y 

$ 

$ 

$ TYPE ENGLISH.DAT 

Student: JOHN SMITH Average: 74.7 
Student: MARY HAGERTY Average: 81.67 
Student: HOSIAH HOWER Average: 83.0 
S$ 
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SUMMARY 


Program Development on a VMS System 


A user must complete the following steps to develop a program: 

¢ Create a text file that contains the source statements of your program. 

* Compile or assemble the text file to produce a file containing object code. 
¢ Link the object file or files to produce an executable image file. 

e Run the executable code produced by the linker. 


e Debug the program to correct errors. 


For more detailed explanations of developing programs, refer to the following documents: 
¢ Guide to VMS Programming Resources 


¢ VMS DCL Dictionary 
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MODULE 11 
EXERCISES 


EXERCISES 11-1 





HARDWARE AND SOFTWARE OVERVIEW 


WRITTEN EXERCISE | 


In the exercise below, match each description with the appropriate component of the hardware 
environment. Components of the hardware environment may be used once, more than once, or 
not at ail. 


Hardware Components 





a. CPU 

b. Console Subsystem 

c. Main Memory 

d. 1/O Subsystem 

Descriptions 

ls Stores instructions and data 

2 % Used to monitor and control the system 

3. >? Consists of peripherals 

4. _*_ Executes instructions 

5. _© Used for starting up and shutting down the system 


EXERCISES 11-3 


Write the letter of the term that best completes each of the following statements. 
1. (-__ are used to connect the various subsystems of the computer. 


a. Peripheral devices 

b. Network communication devices 
c. Interconnect devices 

d. Storage devices 


es % have a screen for displaying information. 


a. Hardcopy terminals 
b. Video terminals 

c. Laser printers 

d. Mass storage devices 


3. fF is NOT a peripheral device. 


a. Terminal 
b. Printer 
c. CPU 
d. Disk drive 
4. [ are high—speed machines that are usually used for large quantities of stored output. 


a. Hardcopy terminals 
b. Disk drives 

c. Laser printers 

d. Line printers 


ae is NOT a type of disk. 


a. Reel 

b. Cartridge 
c. Diskette 
d. Disk pack 


6. AK record data on magnetic media. 


a. Disk drives 

b. Tape drives 

.c. Terminal servers 

d. VAXcluster systems 
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WRITTEN EXERCISE II 


The example on the following page displays the characteristics of a privileged process on your 
system. Using the information displayed in the example, determine the vaiue of each of the 
following parameters: 


IF 


v 


o ON AH PF Hw 


, * 
Ross, 
ivi ae, 
SS aS Pte ET 


Papa ces 
tf 3 tad 4 
f woe 


wr 
S oAyl ao ee tae 
rr lad ae ee 


Account name 


, Default Device and Directory Specification 


Interactive Terminal Specification 
Password 
Process Identification Code 


Process Name 


Swe User Identification Code 2:2, 





User Name 


Priority 


Privileges (list them) 


13. 4: 

4, ~*~ 

15. 

16. 

17. 7 

18. |VvoeN CPU Limit 

19. b> : Open File Quota 
20. Subprocess Quota 
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KAO proeess yale 


Example 11-1: Process Parameters of a Sample Interactive Process 


31-DEC-1987 13:45:39.54 
Pid: 20400140 Proc. 
Priority: 4 
Devices allocated: VTALS5: 
Process Quotas: 
Account name: 
CPU limit: 
Buffered I/O byte count quota: 
Timer queue entry quota: 
Paging file quota: 
Default page fault cluster: 
Enqueue quota: 
Max detached processes: 


VTAL5: 
name: SMITH 


VMS 


Accounting information: 


Buffered I/O count: 21298 
Direct I/O count: 11639 
Page faults: 26172 
Images activated: Liz 
Elapsed CPU time: 0 
Connect time: 0 


Process privileges: 


GRPNAM may insert 
GROUP may affect 
TMPMBX may create 
NE TMBX may create 


Process rights identifiers: 
INTERACTIVE 
LOCAL 
VMS 
SYSSNODE_SUPER 


Process Dynamic Memory Area 


Default file spec: 


SMITH 
{GROUP11, SMITH] 


User: 
Wics 
DISK: [SMITH] 


Infinate Direct £/0O limit: 
12192 Buffered I/O limit: 
10 Open file quota: 
9063 Subprocess quota: 
64 AST limit: 
40 Shared file limit: 


1 Max active jobs: 


Peak working set size: 1500 
Peak virtual size: 1789 
Mounted volumes: 0 


00:11:33.90 
04:58:58.78 


in group logical name table 
other processes in same group 
temporary mailbox 

network device 


Current Size (bytes) 25600 Current Total Size (pages) 
Free Space (bytes) 21184 Space in Use (bytes) 
Size of Largest Block 21072 Size of Smallest Block 


Number of Free Blocks 
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3 Free Blocks LEQU 32 Bytes 


18 
18 
63 


22 


50 


4416 


56 


Match each of the following operations with the parameter that controls your ability to perform 


it. Some operations are controlled by more than one parameter. 


Parameters 


a. 


Password 

Priority 

Privilege 

Process Identification Number (PID) 
Resource Limit 

User Identification Code (UIC) 


User Name 


Operations 


ih 


2 
ie OQ. 
4 


(+, Legging in to your system 


~-_ Deleting a file that belongs to another user 





& Creating a group logical name 








» Opening a large number of files 


EXERCISES 11-7 


GETTING STARTED 


LABORATORY EXERCISE I 


If you have not already done so, obtain your user name and password from your instructor. 
Complete the following activities at an interactive terminal: 


1. Log in to the system, using the user name and password assigned to you. 

2. Type the following command lines at your terminal. After each command, press <RET>. 
- SHOW TIME 
¢ SHOW USERS 
¢ SHOW TERMINAL 


3. Log out of the system. 
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LABORATORY EXERCISE Il 


1. Enter the following command line at your terminal: 


PRODUCE NONESUCH.FIL 


since neither the command nor the parameter of the preceding command line exists, the 
operating system will display one or more error messages at your terminal. 


a. How severe was this error? tween 


2. Use the command line editor to recall the PRODUCE command and change it to the TYPE 
command. Now execute the command and observe the results. 


a. How severe was this error? 4. or 
b. What part of the system produced this error message? /2 1S 


c. Did the message text differ from the previous exercise? /4’¢ rile ~~ 


EXERCISES 11-9 


WRITTEN EXERCISE | 


Match the letter of a special function key with each of the operations described below. You may 
not use every letter in the list. 


Special Function Keys 








a. <CTRL/B> 

b. <CTRL/O> 

c. <CTRL/Q> 

d. <CTRL/R> 

e. <CTRL/S> 

f. <CTRL/U> 

g. <CTRL/Y> 

h. <DEL> or <RUBOUT> 

i. <RET> 

Operations 

ete 1D You have logged in to your system. A long string of messages, all of which you 
have seen before, scrolls past on your screen. Suppress the messages, without stopping 
or aborting the program that produces them. 

2. He You have just typed the string TYPE FILES. The cursor is positioned immediately 
after the ampersand (&). Delete the ampersand (&). 

3. (> You have entered the SHOW SYSTEM command. A listing of users on your system 
scrolls past on your screen. Abort further execution of the command and return control to 
your terminal. 

€ 4. a You have entered the following command lines at your terminal: 


_$ DIFFERENCES/IGNORE=BLANK LINES -<RET> 
_$ FILE1 -<RET> 
_$ FILES 


The cursor is immediately to the right of the number eight on the last line. Delete the last 
line, without deleting the preceding lines of the command string. 
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2 You have entered the following string at your terminal: 


S$ SHOW PROCESS/ALL<RET> 


Lines of information scroll past on your terminal screen. Stop the display and halt, but do 
not abort, the program that generates it. 
U Resume generation of the display that you stopped in the preceding operation. 
D You have made extensive corrections to a command line at a hardcopy terminal. 
The output looks like this: 





$ PRYNT\TNY\NT9\9\ FILIN\NI\ 
Display the line without the echoed corrections. 


h You have just issued a command line. Recall this command. 
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LABORATORY EXERCISE Ill 


Log in to your system and use the online Help facility to obtain the information listed below. 
When you have finished your work, log out. 


1. 


2 
3. 
4 


A listing of all topics available through the Help facility 

A description of the login procedure 

A description of the /FULL qualifier of the LOGOUT command 
A description of the TIME option of the SHOW command 
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LABORATORY EXERCISE IV 


1 


Determine the following characteristics of your terminal: 

a. Number of characters displayed in an output Line +. 
b. Receive speed -’-. 5.5 
c. Transmit speed 7705 
d. Terminal type (LA34, VT100, and so on) V3 5 5 
Determine the value of each of the following process parameters: 
a. Account Name Uc. 

b. CPU Time Limit nim. 

c. Default Directory Specification Prec gs ie Coa 
d. Default Device for Input and Output 7 

e. Priority 4 


nretnaeet 


e e hal ae Se me Fy 7 
Privileges LAD eA ea (ELAS 


fe a NSS 
é 


oath 
e 


; wv 
4 8g 
qemu TA, 


Process Identification Code 2207 a AS 2? 


I wees 
a ; F ety 


> «© 


. Process Name O<)< 


User Identification Code [vc.1 27] 


rt 


j. UserName UC i+ 8 a 


Display the names of all processes running on your system. ~’ 


Display the names of all users on your system. <3 “eo eee 


taut’? 


Display the names of all devices on your system. x .2..,, ao- 


ren Hote LE SN GREE de tthe Ga ee 
“wy fee det PS Coe teed tS 
ve 


Log out of your system. 


EXERCISES 11-13 


CREATING AND EDITING TEXT FILES 


INTRODUCTION TO THE LABORATORY EXERCISES 


Students should feel free to choose either the EDT Editor exercises or the EVE Editor exercises. 
They should choose the editor that they will be primarily using. 


However, if they would like practice in both editors, they can complete all the exercises for this 
module. | 
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LABORATORY EXERCISE | - THE EDT EDITOR 


1. Use the EDT editor to create a text file named EXERCISE1.TEXT. 
a. Invoke the EDT editor, using the appropriate DCL command. 
b. Notice the message displayed on the terminal screen. 
c. Change from Line mode to Keypad mode. 


2. Before you begin entering text, you should become familiar with the Help facility that is a 
part of the EDT editor. 


a. Invoke the Help facility by pressing the appropriate key. 
b. Display information about specific keypad keys. 
c. Exit from Help. 


3. Type in the following text: 


The purpose of this exercise is to allow 
you practice using the basic capabilities 
of the EDT Editor Utility. 


4. Leave the editing session normally. 
a. Return to Line mode. 
b. Type in the command that ends the session and saves your actions. 


c. Notice the system message displayed on the terminal screen. 
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Begin another editing session. 
a. Invoke the EDT editor, using the appropriate DCL command. 
b. Notice that the first line of the file is displayed on the terminal screen. 


c. Change from Line mode to Keypad mode. The file’s contents are displayed on the 
screen. | 


Modify the text. 


a. Using the appropriate keys, move the cursor to the beginning of the word "basic" in the 
second line. | 


b. Delete the words "basic capabilities" and modify the line so that it reads: 


you practice using the simpler functions 


End the editing session. 
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LABORATORY EXERCISE Il - THE EVE EDITOR 


1. Use the EVE editor to create a file called EXERCISES.TEXT. 
a. Notice the messages that are displayed on the terminal screen. 

2. Type in the lines listed below. DO NOT press the RETURN key while you are typing. The 
automatic word.wrap feature causes new lines to begin when text reaches the right margin 
of the terminal screen. 


Notice the automatic word wrap feature of EVE. 


This is an exercise that uses the EVE editor. 

This editor allows you to type text into a file. 

The word wrap feature will automatically wrap lines as you type, 

so that you do not have to press the RETURN key at the end of each line. 


3. End the editing session and save your work. 
a. Use the appropriate key sequence or line—~—mode command to end the editing session. 
b. Notice the system messages displayed on the terminal screen. 
4. Begin another editing session. 
a. Notice the system messages displayed on the terminal screen. 
5. Modify the text of the first line to read: ae 
This is an example that uses the EVE editor. re 
a. Move the cursor to the beginning of the word "RETURN." 
b. Use the appropriate key to delete the word "RETURN." © 1: 
c. Move the cursor to the beginning of the word “example.” 
d. Use the appropriate key to switch from Insert mode to Overstrike mode. ria 
e. Type over the words “example that uses" with the words “exercise that uses." 


6. End the editing session normally. 


EXERCISES 11-17 


LABORATORY EXERCISE Ill - THE EVE EDITOR 


This exercise lets you practice editing more than one file on your terminal screen. 


1 


2 
3 
4. 
5 


Edit a file of your choice. 

Split your terminal screen into two windows. 7i2° »< UP Ss 
Edit another file of your choice. GET FE Fe.F © 

Move text from one file into the other file. Iv@uvyoe eA. fom 


Exit the file so the moved text is saved. 
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COMMUNICATING WITH OTHER USERS 


LABORATORY EXERCISE | 


1. Invoke the Mail utility and send several mail messages to someone in your class. 
Have your mail recipient send mail messages to you. 

Read your messages. 

Obtain a list of your mail messages. 

Read only the second mail message. 

Delete the fourth mail message. 


Create a text file in your default directory. Send this file as a mail message. 


oOo mM eS oe FF YS PN 


Pick a message and move it to a folder named Test. Select the Test folder and check to 
see if the message is there. 


9. List the folders you have. In addition to the folder you just created, what other folders do 
you have? 


10. Create a distribution list for Mail. Include several members of your class. Send a short 
message to the people on the distribution list. 
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LABORATORY EXERCISE I! 


1. Invoke the Phone utility. 


Establish a phone connection with one of the users. 


= fe ON 


Terminate all conversations. = gyi co 
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Obtain a list of available users. fy Dijg WE 6 Pe 


LABORATORY EXERCISE Ill 


Send a request to a system operator using the REQUEST command. 
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MANAGING FILES 


WRITTEN EXERCISE | 


Suppose your default directory contains the following files: 


A.DAT;1 A.FOR; 2 AREA.FOR; 2 AREA .FOR;1 
BsDAT?3 B.FOR;1 C.DAT; 4 CuPOR? 1 
MAILD22 .DAT;2 MATILF22.DAT;2 MAILIST.COB;1 MAILJ14.DAT;1 


List the files that are specified by the following file specifications (using the DIRECTORY 
command): 


rans oo PO" an 

we P ak gt a ae 
a ats * i aE ithe by hs : oy Soon v A ¥ , 

a = FOR ‘2 a wie Zs jai é ge ferry & Dyes 2 

. ° ; ED ee a hae FS é 
ie ee 
yt se ORO i ‘ i> wee ff pegs rae) Q : ?} we LAN, * : 1h wt 
» ‘ eae oS Bel Fe ene fede ft 7 ft a Lat! te ‘ 2 of arn, ge nN at aes ae ee “ 
b * FOR a wt “3 : “ ‘a 5 ae Fe fp B ie é ee h § ft at ) re PP ye baie 8? iP ey ae i E 
e ° fee yw GM Oe gst c 4 bac K 5 ud } nes oe ae: 
pai ae ame a ie : He a 

Cc A* wk a we nt cs, at : Py ets :. cia) FN P ae e [ 1 ie, a 3 ‘ " eae a M oy ae : 
e ry 3 fa ‘ <¥ i" E re : : : ‘ r or 7 fos Cons % ee f 4 ii mans A 
: s, : ae ? & 


see? 


d. A%%%.*;* Pie ig eo ae Re 
ee he” ; : eit pa? ‘. OP 


oO ta > eet gre 3 Ps A wen Sa Mee . 
e. 4. DAT oy SB tae a 28 ol See g pec Cz PAT ; 4 


¥ 


f. “ye pre é 


Give a single file specification that describes the following lists of files: 
a. A.DAT;1,A-FOR;2 AA. ¥ 

b. A.DAT;1, B.DAT;3, C.DAT;4 

c. MAILD22.DAT;2, MAILJ14.DAT;1, MAILF22.DAT;2 MAL DAT 
d. A.DAT;1, MAILJ14.DAT;1 0 Dy 
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WRITTEN EXERCISE Il 


Next to each file maintenance operation, write the letter that corresponds to the VMS command 
best suited to accomplish it. Specify each command at least once. 


Commands 


a 


sa -7Oo aN oP 


APPEND 
COPY 
DELETE 
DELETE/CONFIRM 
DIFFERENCES 
DIRECTORY 
DIRECTORY/OUTPUT=file—specification 
PRINT 
PURGE 
RENAME 
TYPE 


Operations 


1. 


o 9 NO HW PF WY ND 


wud, 
ad 


11. 


et 
ie 

a 
gM. 





Display the contents of a file at your terminal. 


Display the contents of your default directory at your terminal. 


\ 
(_2*\) Remove a specified file from your default directory. 


{Remove all but the most recent version of a specified file frorn your default directory. 


my 
i oy 


i> Create an exact duplicate of a file in your default directory. 





L List the contents of a file at the default system printer. 
fe Compare the contents of two files. 

Add the contents of one file to another. 

“~ -Change a file name to a new file name. 


D Display the name of each file in your default directory and remove or retain it by 


entering a "Y" or an "N" at your terminal. 


fe 


iw) List the contents of your default directory in a file for future reference. 
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LABORATORY EXERCISE | 


1. Create a subdirectory called [.SUB1]  2.¢@re /pi etacoey Putra, Suet / 


Move yourself to that subdirectory ~. ... 


a8 on ee ee i 
Dee a2 Tete Ce a Sat ws. ae ee 


Obtain a directory listing of all files in the subdirectory 5, .». 


Combine two files to create a new file named NEWFILE.DAT 


Create another subdirectory beneath [.SUB1] and name Ee new penctat [.SUB2] 


’ 4 ee fa Soe ; ; ” 
fp: 2 ys hee ae oo ha 
és o ae SLi ty Bek ede & foe is ee 5 é. a rie! ws : oe 


Copy some files from [.SUB1] into [.SUB2] 
Ayo Chee gaa Tr as 
OE PPB ae Tee eS 
Obtain a directory listing of all files in the seueuiaeee. 
hie DE ooh PB’ Sebey 27 
Delete both subdirectories D; 2 
in Of 


o O N OD UW BF WO WD 


? : F Hw FP 
VJ ' ie 
%, r aa 
; F ; : 
Z fs are ¢ te ae oh 
ey : 
t #° é $ 
2 Dedak : ( 
OF eg Kbatnk nn - 
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Copy some files from your login directory into [.SUB1] me reser eee 


LABORATORY EXERCISE II 


Det Oe Oe 


1. Create a file in your login directory. What protection code does this newly created file have 


and how did it get that protection code? (a: Reads ts , eee ee ees ee i 
w ‘ fit te FY ; a A” 


2. Change the protection code for this file to (S:R,O:R,G;R,W:R). Display the protection code 


to verify the change. etsy ee a 7 ee ee eS 
ee. i oe ee ee ce a S. {ps Pop, OP lunes i) Ae het 
“ 


3. Delete this file. What happened and why? DEMEP Hrgeune : Sy eee 
Cn ae bE a (Vv as a fe iv # é. fh nk: 
4. Change your default protection code to (S:R,O:RWED,G:R,W:R). Create a new file named 
NEWFILE.TXT. What Pence code does this new ue have and why? 
aye bag ne Ge mp on a) ae Ce ee ) % ye. C Af, 
5. Change your default protection to give all persons in’ VOUT UIC group pen a access and all 
persons in the WORLD category RWE access. 


SG PRATER TIOW = fa /, 


Ta 
woh ze ney CAISG fob & a nf “eat, e5 
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WRITTEN EXERCISE Ill 


Next to each directory maintenance operation, write the letter of the VMS command best suited 
to perform the job. You may use each command more than once; you may not use others at ail. 


Commands 


COPY 

CREATE 
CREATE/DIRECTORY 
DELETE 
DELETE/DIRECTORY 
DIRECTORY 
RENAME 

SET DEFAULT 

SET PROTECTION | 


7 Ore eo 2 


Per eee als 














SHOW DEFAULT 

SHOW PROTECTION 
Operations 
1.2 O Display the name of your current default directory. 
2. 4 Display the contents of a directory hierarchy. 
3. = a Remove a directory from a directory hierarchy. 
4. C Adda directory. to a directory hierarchy. 
Bn Move files from one directory to another. 
6. Be Change your current default directory. 
7. _~ _ Change the protection code of a directory file. 
8 Display the name of your current default device. 
9. _/ _ Change your current default device. | 
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LABORATORY EXERCISE Ill 


1. 


Choose a file in your directory. Issue a DCL command to obtain Access Control List infor— 
mation regarding that file. Since hae Gu ee 


aes {yan 


Modify the UIC protection on the above file so that your group has no ACoA Sey preTeerts /=C) 4h 


Modify the ACL information to allow Read, Write, and Execute access to the file. 
| Eprt fac Sieg 


Check to see if an ACL was created. Have some of your fellow students try to access the 
file. 


Delete the ACL on the above file. 
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WRITTEN EXERCISE IV 


Each of the following questions describes an operation a user wishes to perform on a given disk 
or tape file. Given the UIC of the user, and the owner UIC and protection code of the file, its 
directory, or its volume, determine whether the file system will permit the operation to occur. If 
the operation is permissible, write the word TRUE in the space that precedes the question; if it 
is not, write the word FALSE. 


1. _  Auser with a UIC of [100,200] wishes to delete a file on a tape volume. 


NOT Pere ec. ( 
Volume Owner UIC: f[100, 200} 
Volume Protection Code: (S:RWED, O: RWED, G:RWED, W: RE) 


A user with a UIC of [9832] wishes to create a file on an RX33 disk volume. 
SAME GROG oe 


v 

Volume Owner UIC: [363,0] 
Volume Protection Code: (S:RE, O:RWED, G: RE, W) 

3. A user with a UIC of [4,4] wishes to read a file on an RA6O disk volume. 
File Owner UIC: (411,22] rao 
File Protection Code: (S,O:RWED,G,W:R)) 

4. 7 A user with a UIC of [100,200] wishes to update a record in a file on an RA80 disk 

volume. 

Volume Owner UIC: [1,1] 
Volume Protection Code: (S:RWED,0O;RWED, G: RWED, W: RWED) 
Directory Owner UIC: [100,210] 
Directory Protection Code: (S:RWE,O:RWE, G:RWE,W:RE) 
File Owner UIC: [100,210] 
File Protection Code: (S:RE,O:RWED, G: RWE, W:RE) 

eo A user with a UIC of [521,6] wishes to read a file on an RA81 disk volume. 
Volume Owner UIC: rae 
Volume Protection Code: (S:RWED, O: RWED, G:RWED, W: RWED) 
Directory Owner UIC: [$2i,13] 
Directory Protection Code: (S:RWE,0O:RWE,G, W) 
File Owner UIC: f521,.13] 
File Protection Code: (S:R,O:RWED, G:R,W:R) 

d % ee 
4g a 
re al 
Lae \ ‘ oy gs 
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CUSTOMIZING THE USER ENVIRONMENT 


WRITTEN EXERCISE | 


Write the letter of the system—defined logical name below that best fits each of the device and 


directory descriptions on the following page. Some answers require more than one letter. 
System-Defined Logical Names 


SYS$COMMAND 


b. SYSSDISK 


c. 


d. 


SYSSERROR 
SYSSHELP 
SYSS$INPUT 
SYS$LIBRARY 
SYSS$LOGIN 
SYS$NODE 


. SYSSOUTPUT 


SYS$SYSDEVICE 
SYS$SYSTEM 


EXERCISES 


11— 29 


Device and Directory Descriptions 


a a 





specifies the default device to which the system writes output during a terminal 





session. 





2. oe, Specifies the default device to which the system writes messages during a terminal 
session. — 


’ Specifies your default disk. 
specifies the directory in which help files are cataloged. 


specifies the directory in which system libraries are cataloged. 





oe Specifies your default user file directory (UFD). 





N29 9 Pw 
7 


i. Specifies the device from which the command language interpreter and utility pro- 
grams read input during a terminal session. 


8. K Specifies the directory in which operating system programs and procedures are 
aint 


9. AC, ‘ ¢, Specifies your terminal during an interactive process. 
10. ) Specifies the disk on which system programs and routines are stored. 


11. Ht specifies the name of the current network node. 
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LABORATORY EXERCISE | 


Complete each of the following exercises at an interactive terminal. Display only one logical 
name table for each exercise. 


1. Display at your terminal the contents of the logical name table used by your process. This 
particular logical name table contains process—private logical names. 


2. Display at your terminal the contents of the logical name table used by your process and its 
subprocesses. This particular logical name table contains shareable logical names. 


oe Show? GEIS wel, f LOM 
3. Display at your terminal the contents of the logical name table used by your UIC group 


emanate eta e t as mal Kenda 


SHOe. wa ce sak tn fl Se Rue 


4. Display at your terminal the contents of the logical name table used by all system processes. 


This particular logical name table contains shareable logical names. sow cre icone pag 


5. Create a logical name for your default directory. prriwi vam Foes | 


a. Check the proper logical name table to make sure your newly created logical name 


exists. oe 


b. Use the logical name in conjunction with the DIRECTORY command to view the file 
names in your default directory. 


baw 


a 
ee! 


c. Delete your newly created logical name after correctly performing this exercise. 
OE SS ode A BANE 
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LABORATORY EXERCISE II 


Complete each of the following laboratory exercises at an interactive terminal. 


1. 


2 
3 
4 
5 
6 


Create a subdirectory. 


Create a logical r name for your newly created woes : 
> ae pre ee eee AP en eS oars “8. = ee rf A ae: a 
Create a logical name for a text file in your default sinecaans 


DER A CARLES Loewe SIN yt 
Check the process pienicalt name table to see if your new logical names exist. 


Using only logical names, move the text file into your new subdirectory. 


After completing this exercise, remove the above logical names. 


v} s bed > a om z ied _ oe . a wasn : 
D CGS a A a RAE. 


“, : : 
1 ar? ene wd » 
* ota Pom gs t. Aa = haere | ‘ ay ne 
gi, OS ee a Dba ee ae & Ae? 

g red? Ce aa a é a" 
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WRITTEN EXERCISE Ii 


Write the letter of the symbolic name type that best fits each of the following characteristics. 
Symbolic Name Types 
a. Command Synonym 


b. Logical Name 


Characteristics 

1. Represents device, directory, and file specifications | 
Translated by the file system 

Translated by the Command Language Interpreter 
Defined by the direct assignment statement (=) 
Deleted by the DEASSIGN command 

Displayed by the SHOW SYMBOL command 
Defined by the ASSIGN command 


Represents commands and command strings 


aS fF Ss eS ow eS OS CY 


Deleted by the DELETE/SYMBOL command 
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LABORATORY EXERCISE II 


Create global symbols to perform the following tasks. You may create these global symbols 
interactively or in the file LOGIN.COM. 


1. 


2 
3. 
4 
=) 


Display a directory listing along with sizes of all files in your directory. 
Show the time of day. 

Display ail global symbols at your terminal. 

Move to another default directory. 

Return to your original default directory. 


To correct mistakes you may have made when you defined a DCL symbol, use the 
DELETE/SYMBOL command to remove the faulty definition, then enter it again. 


Try the symbols to see if they work. How can you get rid of the symbols without using the 
DELETE/SYMBOL command? 
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LABORATORY EXERCISE IV 


1. Define <KP2> to be the SHOW TIME command. Try it first without the TERMINATE qualifier, 
then with the /TERMINATE qualifier. What is the difference? 


2. Define <KP3> to be the SET DEFAULT command. Create a subdirectory. Try to move to 
the subdirectory by using your newly defined key. | 


3. Delete the key definition for <KP2>. See if it worked by displaying all your key definitions 
again. 


EXERCISES 11-35 


WRITING COMMAND PROCEDURES 


WRITTEN EXERCISE | 


To complete these exercises, use the following symbol definitions: 


COUNT = 2 FILE NAME = "PROGRAM" 
Pl = "MYFILE.TXT" FILE TYPE = ".FOR" 
P2 = "DATA.DAT" 

Part A: 


Each command below uses a symbol in some way. Indicate whether or not the symbol is used 
correctly. If it is used correctly, rewrite the command, replacing the symbol with its value (see 
above). If the symbol is used incorrectly, rewrite the command correctly. 


Examples: 

$ TYPE "Pi" 

Incorrect $ TYPE ’P1’ 

$ EDIT ’P2’ 

Correct $ EDIT DATA.DAT 

1. $ FILE = eee + /FILE TYPE’ 

2. $ WRITE SYSSOUTPUT COUNT " copies of the file” 
3. $ IF COUNT .LT. 10 THEN GOTO END 
4 


S$ WRITE SYSSOUTPUT "The file ’’FILE NAME’’’FILE TYPE’" 
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Part B: 


In the commands below, replace the underlined text with symbols, using the proper symbol 
substitution techniques. 


To complete these exercises, use the following symbol definitions: 


COUNT = 2 FILE NAME = "PROGRAM" 
Pl = "MYFILE.TXT" FILE TYPE = ".FOR" 
P2 = "DATA.DAT" 

Example: 


$ PRINT MYFILE.TXT 
S$ PRINT 'P1’ 


1. 


2 
3 
4 
5 


S$ WRITE SYSSOUTPUT "The file is MYFILE.TXT" 

$ TYPE PROGRAM. FOR 

$ EDIT DATA.DAT 

$ WRITE SYSSOUTPUT "2 copies of the file DATA.DAT exist." 


S FILE = "PROGRAM" + ".FOR" 
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INTRODUCTION TO LABORATORY EXERCISES 


These lab exercises are designed to give you practice in creating, testing, and running command 
procedures. 


The procedures in these exercises will include the commonly used functions of command pro- 
cedures, such as: 


« Terminal input and output 

¢ Symbol assignment and symbol substitution 
° Controlling program flow 

¢ Passing data to procedures 


« Using simple lexical functions 
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LABORATORY EXERCISE | 


LOGIN.COM is one of the most commonly used command procedures. This procedure is ex— 
ecuted automatically each time you iog In to a VMS system. It is used to tailor your working 
environment on the system to better suit your needs. 


Write a LOGIN.COM procedure of your own that performs the following actions: 


Exit if the process mode is not interactive. Use the lexical function FSMODE() to test the 
mode of the process. 


lr FaMODEN wea. ™ INTERACTIVE “ THEAL CLARET" 
2. Define a logical name that points to one of your subdirectories: 
disk_name:[directory_name.subdirectory_name] 
where disk_name is your default disk, and directory_name is your top level directory. 


3. Define global symbols to be used as command synonyms. These command synonyms 
should perform the following actions: 


a. Set default oe 
b. Show all users currently logged in to the system ~~ 
e. Display your current directory ~~ 
d. Set your default to your login disk and directory ~“ - 
4. Display the following information on your terminal: 
a. The current date and time “ 


b. The current default directory f 
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LABORATORY EXERCISE II 


Write a command procedure that allows you to create files that everyone on your system can 
access. The procedure performs the following tasks: 


1. 


2 
3. 
4 
5 


Asks for the file name, if it is not provided. 

Displays a message that indicates the name of the file being edited. 
Transfers control to the terminal and then allows you to edit the file. 
Sets the protection on the file so that the WORLD has READ access. 


Prints a copy of the file for yourself, if you choose. 


The name of the file you are creating should be supplied as P1. 


This exercise uses terminal input and output including: 


INQUIRE 
WRITE SYS$OUTPUT 
DEFINE/USER_MODE or ASSIGN/USER_MODE 
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OPTIONAL LABORATORY EXERCISE 


Write a command procedure that displays a message on your terminal screen that states when 
you will return. The procedure performs the following: 


1. Asks you for the number of minutes you will be away. 

2. Erases the screen and then displays the message, 12 lines from the top: 
"Back in N minutes" 
(where N is the number of minutes you supplied in Part 1). 


3. it waits, and at one—minute intervals subtracts 1 from the number of minutes, erases the 
screen, and redisplays the message with the new value. 


4. When only one minute is left, it erases the screen and displays the message: 


"Vl be right back." 


This exercise uses terminal input and output commands, including: 
¢ INQUIRE/NOPUNCTUATION 

¢ WRITE SYS$SOUTPUT 

© TYPE SYS$INPUT 


This procedure also uses the DCL command WAIT. For more information on this command, 
refer to the VMS DCL Dictionary or use the HELP command. 


This command procedure does not use lexical functions. 
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USING DISK AND TAPE VOLUMES 


WRITTEN EXERCISE | 


The list below contains the major steps that you must complete to create and use a private vol- 
ume. Indicate the order of these steps by writing the appropriate number in the space preceding 
each step. 

1. Allocate device 

Deallocate device 

Dismount volume 

Initialize volume 


Load volume 


Mount volume 


=~ 2 oY SS & 


Unioad volume 
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WRITTEN EXERCISE Il 


Choose the VMS command best suited to perform each of the following operations and write its 
letter in the space provided. 


VMS Commands 


a. ALLOCATE 

b. DEALLOCATE 

c. DISMOUNT. 

d. INITIALIZE 

e. MOUNT 

f. SHOW DEVICE/FULL 

Operations 

1. _____—- Build the appropriate structure on a disk (usually used for a new tape). 
2. _______ Terminate access by your process to the contents of a volume. 
3. ___ Display the owner UIC and protection code of a volume. © 

4. ______Initiate access by your process to the contents of a volume. 

5. ______ Release a device from exclusive use by your process. 

6. __ Reserve a device for exclusive use by your process. 
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WRITTEN EXERCISE III 


Write a VMS command string to perform each of the following operations. 

1. Allocate any available tape unit to your process and assign the logical name TAPE to it. 
Initialize a tape volume that you have loaded on TAPE. Assign the label TAP_BK to the unit. 
Mount TAP_BK on the tape device so that the Backup utility can process it. 

Back up all files in your default directory to a save set on TAP_BK. 

List the contents of the ae set TAP_BK at your terminal. 

Terminate access to TAP_BK, allowing the system to automatically unload the volume. 


Release the tape device so others on your system can use it. 


Sse ee eS 


Delete the logical name TAPE from the logical-name table that stores it. 
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LABORATORY EXERCISE | 


Complete the following exercises at an interactive terminal. Note that your device names may 
differ from the device and directory names given in the solutions. 


1. Allocate the tape. 

Initialize the tape, giving it a label name of MYTAPE. 
Mount the tape, so that BACKUP can be used. 

Obtain a listing of the files in your directory. 

Transfer all files from your directory to the tape. 

Confirm that all files transferred successfully to the tape. 


Dismount the tape. 


So “NM eS ao Ff YY KN 


Deallocate the tape. 
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SUBMITTING BATCH AND PRINT JOBS 


LABORATORY EXERCISE | 


NOTE 


Several of the laboratory exercises in this module ask you to create command procedure 
files. | 


Complete the following exercises at an interactive terminal. 


1. 


2. 


Choose a text file and print it, using the generic print queue SYS$PRINT. 


Use a single PRINT command to print two copies of the same file, giving the print job priority 
3 on SYS$PRINT. 


Display a list of all queues on your system and all jobs in the queues. 

Select an execution queue from the queue display. (An execution queue will have the same 
name as its associated device, without the colon.) Print the same file, queuing it directly to 
the physical queue. 


Choose two text files. Print these two files so that you get two copies of the first file and 
three copies of the second file. 


Send a text file to the print queue, requesting that the file not be printed until an hour from 
now. 


Display the queue status of the job waiting to be printed. Delete this job from the queue. 
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LABORATORY EXERCISE Il 


1. Display at your terminal screen all of the batch queues on the system. 


2. Submit a command procedure to the batch queue that displays the time, displays all pro— 
cesses on the system, and shows all logical names on the system. Save the log file. You 
will need to examine it shortly. 


3. Submit the above command procedure to batch so that the log file will not be printed. 
4. Submit the above command procedure to batch so that the log file will not be created. 
5. Examine the log file created in Step 2. Answer the following questions: 


— Find the entry for your batch job from the SHOW SYSTEM command. What was its 
process ID? 


— Did your LOGIN.COM file execute? Did the system-wide login procedure execute? 
— How much CPU time did your batch job use to execute? 


— How much elapsed time did your batch job use to execute? 
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HARDWARE AND SOFTWARE 
OVERVIEW—SOLUTIONS 


WRITTEN EXERCISE | 


In the exercise below, match each description with the appropriate component of the hardware 
environment. Components of the hardware environment may be used once, more than once, or 
not at all. | 

Hardware Components 

a. CPU 

b. Console Subsystem 


c. Main Memory 


d. 1/O Subsystem 
Descriptions 
1. Cc Stores instructions and data 


Db Used to monitor and control the system 





a Executes instructions 





2 
3. d Consists of peripherals 
4 
5 


°) Used for starting up and shutting down the system 
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a 


Cc are used to connect the various subsystems of the computer. 


. Peripheral devices 

. Network communication devices 
. Interconnect devices 

. Storage devices 


ao Oo p 


b have a screen for displaying information. 


a. Hardcopy terminals 
b. Video terminals 

c. Laser printers 

d. Mass storage devices 


C is NOT a peripheral device. 


a. Terminal 


b. Printer 
c. CPU 
d. Disk drive 


_ Write the letter of the term that best completes each of the following statements. 


d are high-speed machines that are usually used for large quantities of stored output. 


a. Hardcopy terminals 
b. Disk drives 

c. Laser printers 

d. Line printers 


a is NOT a type of disk. 


a. Reel 

b. Cartridge 
c. Diskette 
d. Disk pack 


b record data on magnetic media. 


a. Disk drives 

b. Tape drives 

c. Terminal servers 

d. VAXcluster systems 
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WRITTEN EXERCISE II 


Compare your answers with those shown below. For additional information, consult your instruc— 
tor. | 


1. VMS _ Account name 

DISK: SMITH] Default Device and Directory Specification 
VTA15: Interactive Terminal Specification 

(Not Displayed) Password 

20400140 Process Identification Code 

SMITH Process Name 

[GROUP11,SMITH] User Identification Code 


SMITH User Name 


o Sf tS SPE Ce UCP 


_4 ___ Priority 
Privileges (list them) 

10. GRPNAM 

11. GROUP 

12. TMPMBX 

13. NETMBX 

14, Infinite CPU Limit 

15. 63 Open File Quota 


16. 2 Subprocess Quota 
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Match each of the following operations with the parameter that controls your ability to perform 
it. Some operations are controlled by more than one parameter. 


Parameters 

a. Password 

b. Priority 

c. Privilege 

d. Process Identification Number (PID) 

e. Resource Limit 

f. User Identification Code (UIC) 

g. User Name 

Operations 

1. _g,a_ Logging in to your system 
To log in to a system, you must know the user name of a record in the UAF. You must also 
Know the password that corresponds to that user name. 

2. ¢,f Deleting a file that belongs to another user 
Your ability to delete a file depends on your UIC. 

3. _¢ Creating a group logical name 

4. _e@ Opening a large number of files 


A resource limit (FILLM) determines the number of files that you can open simultaneously. 
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GETTING STARTED—SOLUTIONS 


LABORATORY EXERCISE | 


Press <RET> on the terminal keyboard 


At the Username: prompt, type your user name <RET> 
At the Password: prompt, type your password <RET> 


_ If typed successfully, you should get a "Welcome" message from the system. 
unsuccessfully, the system will output an error message to your terminal, notifying you that 
either your Username or Password was illegal. Re—-typing your Username and Password 


will correct this situation. 


© SHOW TIME 


$ SHOW TIME<RET> 
31-DEC-1987 14:10:32 


¢ SHOW USERS 


S$ SHOW USERS<RET> 


VAX/VMS Interactive Users 
Total number of interactive users 


Username Process Name “PID 
BECKER BECKER 20200332 
CHAPUT Mary 20200342 
COVERDALE COVERDALE 20200390 
GOEHRING Judy 202003A7 
SMITH SMITH 20200331 
JOHNSTON JOHNSTON 20200352 
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Type the following command lines at your terminal: 


Log in to the system, using the user name and password assigned to you. 


31-DEC-1987 13:30:33.86 


= 6 


Terminal 
VTA115: 
VTA111: 
VTA131: 
VTA139: 
VTA145: 
VTA124: 


LTA76: 
LTAS7: 
LTA74: 
LTA82: 
LTA88&: 
LTA6?7: 


SHOW TERMINAL 


S$ SHOW TERMINAL<RET> 


Terminal: 


9600 
9600 


input: 
Output: 


_VTA145: 
Physical terminal: 


Device Type: PRO Series Owner: 
_LTA88: Username: 
Drrilis 30 Width: 80 
CREiLLs. +0 Page: 24- 


Terminal Characteristics: 


Interactive 

No Hostsyncec 

Wrap 

Broadcast 

No Modem 

No Brdcstmbx 
Line Editing 

No Secure server 
No SIXEL Graphics 
ANSI_CRT 

Edit mode 


3. Log out of the system. 


S$ LOGOUT<RET> or 
$ LOGOUT/FULL<RET> 


Echo 

TIsync 

Scope 

No Readsyncec 

No Local_echo 

No DMA 

Overstrike editing 
Disconnect 

No Soft Characters 
Regis 

DEC CRT 


Type ahead 
Lowercase 

No Remote 

No Form 

No Autobaud 
No Altypeahd 
No Fallback 
No Pasthru 
Printer port 
No Block _mode 
No DEC CRT2 


SMITH 
SMITH 


Parity: None 


No Escape 

Tab 

No Eightbit 
Fulldup 

Hangup 

set speed 

No Dialup 

No Syspassword 
Application keypad 
Advanced video 
No DEC CRT3 
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LABORATORY EXERCISE Il 


S PRODUCE NONESUCH.FIL<RET> 
SDCL-W-IVVERB, unrecognized command verb - check validity 
and spelling \PRODUCE\ 


a. How severe was the error? 
lt was a warning. 

b. What part of the system produced this error message? 
DCL was the part of the system that was upset. 


2. Use the command line editor to recall the PRODUCE command and change it to the TYPE 
command. Now execute the command and observe the results. 


$ TYPE NONESUCH.FIL 


*STYPE-W-SEARCHFAIL, error searching for DISK: [SMITH] NONESUCH.FIL; 
-RMS-E-FNF, file not found. 


a. How severe was this error? 
Severity levels of warning and error. 

b. What part of the system produced this error message? 
Messages came from the TYPE program and RMS. 

c. Did the message text differ from the previous exercise? 


The first exercise was an Unrecognized Command while the second was a Nonexistant 
File. 


The system notifies you that after searching for the file it cannot be found since it does 


not exist. To correct the error, re-issue the TYPE command followed by a legal file 
name. | 
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WRITTEN EXERCISE | 


1. b You have logged in to your system. A long string of messages, all of which you 
have seen before, scrolls past on your screen. Suppress the messages, without stopping 
or aborting the program that produces them. 


2. h You have just typed the string TYPE FILE&. The cursor is positioned immediately 
after the ampersand (&). Delete the ampersand (&). | 


3. g You have entered the SHOW SYSTEM command. A listing of users on your system 
scrolls past on your screen. Abort further execution of the command and return control to 
your terminal. 


4, f You have entered the following command lines at your terminal: 


$ DIFFERENCES/IGNORE=BLANK LINES -<RET> 
_$ FILE1 -<RET> 
_$ FILES 


The cursor is immediately to the right of the number eight on the last line. Delete the last 
line, without deleting the preceding lines of the command string. 


5. e You have entered the following string at your terminal: 


$ SHOW PROCESS/ALL<RET> 


Lines of information scroll past on your terminal screen. Stop the display and halt, but do 
not abort, the program that generates it. 


6. Cc Resume generation of the display that you stopped in the preceding operation. 


7. d You have made extensive corrections to a command line at a hardcopy terminal. 
The output looks like this: 





S PRYNT\TINY\NT9\9\ FILIN\NI\ 
Display the line without the echoed corrections. 


8. a You have just issued a command line. Recall this command. 


EXERCISES 11-55 


LABORATORY EXERCISE III 


Use the following commands: 


1. A listing of all topics available through the Help facility 


S HELP 


2. A description of the login procedure 


S$ HELP LOGIN 


3. A description of the (FULL qualifier of the LOGOUT command 


$ HELP LOGOUT/FULL 


4. Adescription of the TIME option of the SHOW command 


S$ HELP SHOW TIME 
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LABORATORY EXERCISE IV 


1. To display the characteristics of your terminal, enter the SHOW TERMINAL command. 


a. The WIDTH setting of your terminal determines the number of characters displayed in 
an output line. 


b. The receive speed of your terminal is the first number specified for the SPEED setting 
of your terminal. 


c. The transmit speed of your terminal is the second number specified for the SPEED 
setting of your terminal. 


d. Your terminal type is the first value that appears following the terminal name in the 
SHOW TERMINAL display. If the terminal type (/VT52, /VT100, /LA36, /LA120, or 
some other value) does not match the physical characteristics of your terminal, consult 
your system manager. 
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2. To display the specified process parameters, enter the command lines shown below and 
look for the information specified within the parentheses. 


@. $ SHOW PROCESS/QuoTas (Account Name) 
b. $s sHow PROcESS/quotas (CPU Limit) 

C. $ sHOw PROcESS (Default File Specification) 
d. s SHOW TERMINAL (or $ SHOW PROCESS) 
@. $ sHow PRocEss (Priority) 

f. $ SHOW PROCESS/PRIVILEGES (Privileges) 

G. $ sHOw Process (PID) 

h. $ sHow Process (Process Name) 

i. $ sHOw PRocEss (UIC) 

j. $ sHOw PRocess (User) 


3. Display the names of all processes running on your system. 


S$ SHOW SYSTEM 


4. Display the names of all users on your system. 


$ SHOW USERS 


5. Display the names of all devices on your system. 


S$ SHOW DEVICES 


6. Log out of your system 


$ LOGOUT or 
$ LOGOUT/FULL 
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CREATING AND EDITING TEXT FILES—SOLUTIONS 


LABORATORY EXERCISE | —- THE EDT EDITOR 


1. To create the file: 


a. Enter the command: 


S$ EDIT EXERCISE1.TEXT 


b. The system displays the following: 


Input file does not exist 
[EOB] 


* 


The message indicates that the file EXERCISE1.TEXT did not previously exist in your 
directory. The [EOB] marker indicates the end of the buffer. The asterisk indicates that 
you are in Line mode. 


c. To enter Keypad mode, type the CHANGE command at the line-mode prompt, then 
press <RET>: 


* CHANGE<RET> 


The screen display erases, and the [EOB] marker appears in the upper left corner of 
the screen. 


2. To become familiar with the available Help: 
a. Invoke the Help facility from Keypad mode: 
Press <PF2> on the keypad. 
or 
Press <HELP> (on the VT200 keyboard). 


The keypad diagram is displayed on your terminal screen. 
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b. You can display an explanation of each defined key by pressing the key while in HELP. 
You might want to begin with the following keys: 


HELP (PF2) 

DELETE 

DOWN ARROW 

GOLD (PF1) 
DELETE/UNDELETE LINE (PF4) 


Examine any of the key definitions you wish. 


c. To leave Help: 


Press the SPACE BAR 


Type in the text as indicated. 


Note that EDT does not automatically wrap at the end of a line. You must explicitly press 
<RET> to insert carriage returns into the text. 


To end the session and save your work: 


a. Press <CTRL/Z>. This returns you to Line mode. 


b. At the line-mode prompt, type the EXIT command and press <RET>. 


*EXIT<RET> 


c. The system displays the full file specification and the file’s length in lines. The system 
then returns you to the DCL level. 


SDISK: [SMITH] EXERCISE1.TEXT;1 3 lines 
S$ 
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To edit the file: 


a. Enter the command: 


5S EDIT EXERCISE1.TEXT 


b. The system displays the following: 


1 The purpose of this exercise is to allow 
* 


The first line of text is displayed on the screen. 


c. At the line-mode prompt, type C then press <RET>. The contents of the file EXER- 
CISE1.TEXT are displayed on the screen. 


To modify the text: 


a. Move the cursor to the beginning of the word “basic.” You can do this by using either 
the arrow keys, or the keypad keys 0 (zero) and 1 (one). The keypad key 0 moves the 
cursor from line to line; the keypad key 1 moves the cursor from word to word. 


b. To delete a word, press the MINUS (-—) key (below <PF4> on the keypad). The word to 
the right of the cursor is deleted. If you press it again, the next word to the right of the 
cursor is deleted. 


Type in the modifications to the text as shown. 


End the editing session normally by pressing <CTRL/Z>, and then entering the EXIT com- 
mand at the line—mode prompt. 
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LABORATORY EXERCISE II - THE EVE EDITOR 


1. To create the file, enter the command: 


$ EDIT/TPU EXERCISE3 .TEXT 


2. You should see messages at the bottom of the screen indicating that the file EXER-— 
CISE3.TEXT did not previously exist in your directory. The cursor should be positioned 
at the top of the screen, next to the end of file marker. | 


The status line appears at the bottom of the screen. It contains the name of the buffer. In 
this case, the buffer name is the same as the file name. In addition, the status line indicates 
the editing mode and search direction. The default values for these are Insert and Forward. 


3. Type in the text as indicated. 


Note that the EVE editor automatically wraps at the end of a line. You need not press 
<RET> to insert carriage returns into the text. 


4. To end the editing session: 
a. Press <CTRL/Z>. This automatically ends the editing session. 
You can also end an EVE editing session using a line-mode command. 


Press <PF4> or <DO>. At the Command: prompt, type the EXIT command and press 
<RET>. 


b. An informational message is displayed that includes the full file specification and the 
number of line in the file. The system then returns you to the DCL level. 
NOTE 


If you wish to end an EVE editing session without saving changes, you must exit using 
Line mode. Press <PF4> or <DQO>, and at the prompt, type QUIT and press <RET>. 
You will be asked if you wish to continue the quitting process. Type Y and press 
<RET>. 
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Enter the command: 


S EDIT/TPU EXERCISES «TEXT 


A message is displayed indicating that three lines were read from the file, and the contents 
of the file appear on the terminal screen. The cursor is at the top of the file. 


To modify the file: 


b. 


Use the arrow keys to move the cursor to the beginning of the word "Extensible." 
There are two ways to delete words, depending on the terminal you are using: 


- VT100—Press the <COMMAs> (,) key on the keypad. The word to the right of the 
cursor is deleted. Repeat this step three times. 


©  VT200—Press the <F13> key along the top of the keyboard. The word to the right 


of the cursor is deleted. Repeat this step three times. 
To delete single characters, use the <DEL> key (near the <RET> key) on the keyboard. 
Use the arrow keys to move the cursor to the beginning of the word "exercise." 
There are two ways to switch editing modes, depending on the terminal you are using: 
- VT100—Press <ENTER> on the keypad. 
« VT200—Press <F14> along the top of the keyboard. 
The status line indicates that the editing mode is now Overstrike. 


Type in the words "example that uses." Note that when you are in Overstrike mode, the 
new characters replace existing characters. 


End the editing session normally by pressing <CTRL/Z>, and then entering the EXIT com— 
mand at the line—mode prompt. 
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This exercise lets you practice editing more than one file on your terminal screen. 


1. Edit a file of your choice. 


$ EDIT/TPU FILE1L.TXT 


2. Split your terminal screen into two windows. 


TWO WINDOWS 


3. Edit another file of your choice. 


GET FILE FILE2.TXT 
OR 
GET FILE2.TXT 


4. Move text from one file into the other file. 


5. Exit the file so the moved text is saved. 


EXIT 


NOTE 


The editor will prompt you as to whether or not you wish the second file on the screen to - 
be written. Answer Y for Yes or N for No. 
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LABORATORY EXERCISE | 


1 


Invoke the Mail utility and send several mail messages to someone in your class. 


S MAIL<RET> 
MATIL> SEND [messages] 


Have your mail recipient send mail messages to you. 


Read your messages. 


MATL> READ of 
MAIL><RET> or 
MATL> 1 


Obtain a list of your mail messages. 


MAIL> DIRECTORY 


Read only the second mail message. 


MAIL> READ 2 


Delete the fourth mail message. 


MAIL> DELETE 4 or 
MAIL> DELETE (if it is the current message on your screen) 


Create a text file in your default directory. Send this file as a mail message. 


S$ CREATE file-name 
CTRL/Z 

S$ MAIL<RET> 

MAIL> SEND file-name 
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8. Pick a message and move it to a folder named Test. Select the Test folder and check to 
see if the message is there. 


MAIL> READ 1 
MATL> MOVE TEST 


Folder TEST does not exist. 
Do you want to create it (Y/N, default is N)? Y 


MAIL> SELECT TEST 
MAIL> DIRECTORY 


9. List the folders you have. In addition to the folder you just created, what other folders do 
you have? 


MAIL> DIRECTORY/FOLDERS 
You could see three folders named MAIL, NEWMAIL, and WASTEBASKET. 


10. Create a distribution list for Mail. Include several members of your class. Send a short 
message to the people on the distribution list. 


S EDIT DISTRIBUTION.DIS 
USERI 
USER2Z 


CTRL/Z 

EXIT 

$ MAIL 

MAIL> SEND 
TO:@DISTRIBUTION.DIS 
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1. \Invoke the Phone utility. 


S PHONE 
PHONE> 


2. Obtain a list of available users. 


SDIRECTORY 


3. Establish a phone connection with one of the users. 


USER 1 USER 2 
SDIAL user2 ‘SANSWER 


4. Terminate all conversations - 


%SHANGUP or CTRL/2Z 
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LABORATORY EXERCISE Iil 


Send a request to a system operator using the REQUEST command. 


$ REQUEST "Please mount magtape” 
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MANAGING FILES—SOLUTIONS 


WRITTEN EXERCISE | 


1. List the files that are specified by the following file specifications: 


a. *.FOR;2 
A.FOR;2, AREA.FOR;2 


b. *.FOR 
A.FOR;2, AREA.FOR;2, AREA.FOR;1, B.FOR;1, C.FOR;1 


c. At 
A.DAT;1, A.FOR;2, AREA.FOR;2, AREA.FOR;1 


d. AN%oV%o.*5* 
AREA.FOR;2, AREA.FOR;1 


e. %. DAT 

A.DAT;1, B.DAT;3, C.DAT;4 
f. * wee 

All files 


2. Give a single file specification that describes the following lists of files: 


a. A.DAT;1, A.FOR;2 


A.* or A. ¥*;* 


b. A.DAT;1, B.DAT;3, C.DAT;4 
%.DAT or *%.DAT;* | 


c. MAILD22.DAT;2, MAILJ14.DAT;1, MAILF22.DAT;2 
MAIL* .DAT;* or MAIL%%% .DAT 


d. A.DAT;1, MAILJ14.DAT;1 
* DAT; 1 
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Commands 














a. APPEND 
b. COPY 
6. DELETE 
d. DELETE/CONFIRM 
e. DIFFERENCES 
f. DIRECTORY 
g. DIRECTORY/OUTPUT=file—specification 
h. PRINT 
i. PURGE 
|. RENAME 
k. TYPE 
Operations 
1. K Display the contents of a file at your terminal. 
2: f Display the contents of your default directory at your terminal. 
3. Cc Remove a specified file from your default directory. 
4. Remove all but the most recent version of a specified file from your default directory. 
5. b Create an exact duplicate of a file in your default directory. 
6. h List the contents of a file at the default system printer. 
le e Compare the contents of two files. 
8. a Add the contents of one file to another. 
9. | Change a file name to a new file name. 
10. d Display the name of each file in your default directory and remove or retain it by 


entering a "Y" or an "N" at your terminal. 


te 3G List the contents of your default directory in a file for future reference. 
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1. Create a subdirectory called [.SUB1] 


$ CREATE/DIRECTORY [XXX.SUB1] 


2. Copy some files from your login directory into [.SUB1] 


$ COPY/LOG EXISTING-FILE-NAMES [XXX.SUB1]* 


3. Move yourself to that subdirectory 


S$ SET DEFAULT [XXX.SUB1] 


4. Obtain a directory listing of all files in the subdirectory 


S$ DIRECTORY 


5. Combine two files to create a new file named NEWFILE.DAT 


$§ COPY FILE1,FILE2 NEWFILE.DAT 


6. Create another subdirectory beneath [.SUB1] and name the new subdirectory [.SUB2] 


S$ CREATE/DIRECTORY [{XXX.SUB1.SUB2] 
or 
$ CREATE/DIRECTORY [.SUB2] (Assuming you are in the subdirectory [.S0UB1]}) 


7. Copy some files from [.SUB1] into [.SUB2] 


S$ COPY EXISTING-FILE-NAMES [.SUB2]* 


8. Obtain a directory listing of all files in the subdirectory [.SUB2] 


$ DIRECTORY 


9. Delete both subdirectories. 


DELETE *.*;* (Assuming you are in subdirectory [.SUBZ] 
SET DEFAULT [.SUB1]} 

SET PROTECTION=(O:RWED) SUB2.DIR 

DELETE *.%*;* 

SET DEF [-] (Login directory) 

SET PROTECTION=(0O:RWED) SUB1.DIR 

DELETE SUB1.DIR;1 
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1. Create a file in your login directory. What protection code does this newly created file have 
and how did it get that protection code? 


S CREATE MYFILE.TXT 
Type in text 
CTRL/Z 


The protection applied to this file is the default protection the VMS system puts on newly 
created files. 


2. Change the protection code for this file to (S:R,O:R,G;R,W:R). Display the protection code 
to verify the change. 


S$ SET PROTECTION=(S:R,0O:R,G:R,W:R) MYFILE.TXT 
S$ DIRECTORY/PROTECTION MYFILE.TXT 


3. Delete this file. What happened and why? 


$ DELETE MYFILE.TXT;* 


The system issues a system message informing you that you cannot delete this file, because 
you changed the file protection so that the owner does not have DELETE privilege. 


4. Change your default protection code to (S:R,O: RWED,G:R,W:R). Create a new file named 
NEWFILE.TXT. What protection code does this new file have and why? 


S$ SET PROTECTION=(S:R,O:RWED,G:R,W:R) /DEFAULT 


In changing your default protection, you have specified that files now created should have 
this new default protection. You can check this by issuing the command: 


$ DIRECTORY/PROTECTION NEWFILE.TXT 


5. Change your default protection to give all persons in your UIC group RWED access and ail 
persons in the WORLD category RWE access. 


$ SET PROTECTION=(G:RWED, W:RWE) /DEFAULT 
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Commands 


sa -9 AO oD 


a ee 








Operations 
i, 
2. f_ 
3. d 

4. Cc 
Sg 
6& hh _ 
(ao 
8. 

9. h 


COPY 

CREATE 
CREATE/DIRECTORY 
DELETE 
DELETE/DIRECTORY 
DIRECTORY 
RENAME 

SET DEFAULT 

SET PROTECTION 
SHOW DEFAULT 
SHOW PROTECTION 


Display the name of your current default directory. 
Display the contents of a directory hierarchy. 
Remove a directory from a directory hierarchy. 
Add a directory to a directory hierarchy. 

Move files from one directory to another. 

Change your current default directory. 

Change the protection code of a directory file. | 
Display the name of your current default device. 


Change your current default device. 
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LABORATORY EXERCISE III 


1 


Choose a file in your directory. Issue a DCL command to obtain Access Control List infor— 
mation regarding that file. 


S$ DIRECTORY/SECURITY file-name 


Modify the UIC protection on the above file so that your group has no access. 


S SET PROTECTION=(G) file-name 


Modify the ACL information to allow Read, Write, and Execute access to the file. 


S$ EDIT/ACL file-name 
(IDENTIF IER=xxxx, ACCESS=READ+WRITE+EXECUTE) 


Check to see if an ACL was created. Have some of your fellow students try to access the 
file. 


S DIRECTORY/SECURITY file-name 
Delete the ACL on the above file. 


S$ SET ACL/DELETE file-name 


NOTE 


Check with your instructor to see what your GROUP identifier is. 
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3. 


FALSE A user with a UIC of [100,200] wishes to delete a file on a tape volume. 


Volume Owner UIC: [100, 200} 
Volume Protection Code: (S$: RWED, 0: RWED, G: RWED, W:RE) 


Files on a tape volume cannot be deleted. 


TRUE Auser with a UIC of [363,2] wishes to create a file on an RX33 disk volume. 


Volume Owner UIC: [363,0] 
Volume Protection Code: (S:RE,O:RWED, G: RE, W) 


The user is a member of the same group as the owner of the volume. Since group members 
have been granted EXECUTE fights, the user.can create a new file. 7 


TRUE Auser with a UIC of [4,4] wishes to read a file on an RA6O disk volume. 


File Owner UIC: [411,22] 
File Protection Code: (S,O:RWED, G, W:R) 


The user belongs to the SYSTEM user category. System users do not have READ access 
rights to the file. However, READ access rights have been granted to members of the 
WORLD category; therefore, the user will be able to read the file. 


EXERCISES 11-75 


4. TRUE 
volume. 





Volume Owner UIC: 

Volume Protection Code: 
Directory Owner UIC: 
Directory Protection Code: 
File Owner UIC: 

File Protection Code: 


A user with a UIC of [100,200] wishes to update a record in a file on an RA80 disk 


lige dl 
($:RWED,O;RWED, G:RWED, W: RWED) 
[100,210] 

($:RWE,O:RWE, G:RWE,W:RE) 
f100;2701 

(S:RE, O:RWED, G: RWE, W:RE) 


The user can access files on the volume because all access rights to the volume have been 
granted to all user categories. The user is a member of the same group as the owner of 
the file and the directory in which it is listed. Members of the GROUP category have been 
granted WRITE access rights; therefore, the user can update the file. 


FALSE A user with a UIC of [521,6] wishes to read a file on an RA81 disk volume. 


Volume Owner UIC: fac | 

Volume Protection Code: (S:RWED, O: RWED, G: RWED, W: RWED) 
Directory Owner UIC: (aZi523)) 

Directory Protection Code: (S:RWE,O:RWE,G, W) 

File Owner UIC: (S2i54 3. 


File Protection Code: 


(S:R,O:RWED, G:R, W:R) 


The user can access files on the volume because all access rights to the volume have been 
granted to all user categories. The user is a member of the same group as the owner of 
the file and the directory in which it is listed. Members of the GROUP category, however, 
cannot read the directory; therefore, the user will be unabie to read the file. 
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ote 
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CUSTOMIZING THE USER 
ENVIRONMENT—SOLUTIONS 


WRITTEN EXERCISE I 
System—Defined Logical Names 

a. SYSSCOMMAND 

b. SYS$DISK | 

c. SYSS$ERROR 

d. SYS$HELP 

e. SYSS$INPUT 

SYS$LIBRARY 

SYS$LOGIN 


zs © 


SYS$NODE 


SYSSOUTPUT 
j. SYS$SYSDEVICE 
k. SYS$SYSTEM 
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Device and Directory Descriptions 


1 


~~ ee ae bee 


9. 


i. Specifies the default device to which the system writes output during a terminal 
session. 


Cc Specifies the default device to which the system writes messages during a terminal 
session. 


_b ___ Specifies your default disk. 
_d___ Specifies the directory in which help files are cataloged. 

f Specifies the directory in which system libraries are cataloged. 
__g ____ Specifies your default user file directory (UFD). 


e Specifies the device from which the command language interpreter and utility pro— 
grams read input during a terminal session. | 


k Specifies the directory in which operating system programs and procedures are 
cataloged. 





a,c,e,i Specifies your terminal during an interactive process. 


10. j Specifies the disk on which system programs and routines are stored. 


11. 


h Specifies the name of the current network node. 
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Compare your results with those described below. For additional help, consult your instructor. 


Complete each of the following exercises at an interactive terminal. Display only one logical 
name table for each exercise. 


1. Display at your terminal the contents of the logical name table used by your process. This 
particular logical name table contains process-private logical names. 


$ SHOW LOGICAL/PROCESS 


2. Display at your terminal the contents of the logical name table used by your process and its 
subprocesses. This particular logical name table contains shareable logical names. 


$ SHOW LOGICAL/JOB 


3. Display at your terminal the contents of the logical name table used by your UIC group 
member processes. This particular logical name table contains shareable logical names. 


S$ SHOW LOGICAL/GROUP 
(There may not be any logical names defined in this table.) 


4. Display at your terminal the contents of the logical name table used by all system processes. 
This particular logical name table contains shareable logical names. 


$§ SHOW LOGICAL/SYSTEM 
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5. Create a logical name for your-default directory. 


$ ASSIGN WORK2: [SMITH] MYDIR 


a. Check the proper logical name table to make sure your newly created logical name 


exists. 


$ SHOW LOGICAL MYDIR 
"MYDIR" = "WORK2: [SMITH]" (LNMSPROCESS TABLE) 


b. Use the logical name in conjunction with the DIRECTORY command to view the file 


names in your default directory. 


S$ DIRECTORY MYDIR 
Directory WORK2: [SMITH] 


CALENDAR .EXE;1 CLASS.LIST;4 CLOCK .EXE;1 DEG .EXE;1 
JOE_EVE.TPUSSECTION; 1 KEYS .COM; 5 LOGIN .COM; 6 
MAIL .DIRs1 PERSONAL.LGP ; 4 REMLOG.EXE; 1 TODO.DAT;17 
UTL.DIR;1 WEEKDAY .EXE; 1 


Total of 13 files. 


c. Delete your newly created logical name after correctly performing this exercise. 


S DEASSIGN MYDIR 
OR 
$ DEASSIGN/PROCESS MYDIR 
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LABORATORY EXERCISE II 


Compare your results with the example specified. For additional help, consult your instructor. 
Complete each of the following laboratory exercises at an interactive terminal. 


1. Create a subdirectory. 


S$ CREATE/DIRECTORY/LOG [SMITH. TEXT] 
SCREATE-I-CREATED, DISK: [SMITH.TEXT] created 


2. Create a logical name for your newly created subdirectory. 


S ASSIGN [SMITH.TEXT] MY_TEXT 


3. Create a logical name for a text file in your default directory. 


S$ ASSIGN MYFILE.TXT;1 OUTPUT 


4, Check the process logical name table to see if your new logical names exist. 


'$ SHOW LOGICAL/PROCESS 
(LNMSPROCESS TABLE) 


"MY TEXT" = "(SMITH. TEXT] " 

"OUTPUT" = "MYFILE.TXT;1" 
"SYSSCOMMAND" = "_DISKSRTA1:" 
"SYSSDISK”" = "DISK:" 

"SYSSERROR" = " DISKSRTA1:" 
"SYSSINPUT" = " DISKSRTAI:" 
"SYSSOUTPUT" [super] = "_DISKSRTAI1:" 
"SYSSOUTPUT" [exec] = " DISKSRTA1:" 
" TT tt = iA RTA1 : " 


5. Using only logical names, move the text file into your new subdirectory. 


$ COPY/LOG OUTPUT MY_TEXT 
*%COPY-S-COPIED, DISK: (SMITH]MYFILE.TXT;1 copied to 


DISK: [SMITH.TEXT]MYFILE.TXT;1 (1 block) 


6. ' After completing this exercise, remove the above logical names. 


S$ DEASSIGN OUTPUT 
S DEASSIGN MY_TEXT 
$ 
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Write the letter of the symbolic name type that best fits each of the following characteristics. 


Symbolic Name Types 


Command Synonym 


b. Logical Name 


Characteristics 


nF 


0 OP ND mM P WY N 


eee 
a 























Represents device, directory, and file specifications 
Translated by the file system 

Translated by the Command Language Interpreter 
Defined by the direct assignment statement (=) 
Deleted by the DEASSIGN command 

Displayed By the SHOW SYMBOL command 
Defined by the ASSIGN command 

Represents commands and command strings 


Deleted by the DELETE/SYMBOL command 
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Create global symbols to perform the following tasks. You may create these global symbols 
interactively or in the file LOGIN.COM. Your global symbols may differ from the exercise answers. 


1. Display a directory listing along with sizes of all files in your directory. 


$ DS == "DIRECTORY/SIZE" 


2. Show the time of day. 


$ TIME == "SHOW TIME" 


3. Display all global symbols at your terminal. 


$ GLO == "SHOW SYMBOL/GLOBAL/ALL" 


4. Move to another default directory. 


$ MO == "SET DEFAULT" 


5. Return to your original default directory. 


$ RETURN == "SET DEFAULT SYSSLOGIN" 


6. Symbols disappear when you log out. 
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LABORATORY EXERCISE IV 


1. Define <KP2> to be the SHOW TIME command. Try it first without the ‘TERMINATE qualifier, 
then with the /TERMINATE qualifier. What is the difference? 


S$ SET TERMINAL/NONUMERIC 
S$ DEFINE/KEY KP2 "SHOW TIME" 
$ DEFINE/KEY KP2 "SHOW TIME"/TERMINATE 


The difference is the first time you have to press <RET> after pressing <KP2>. The second - 
time the return is automatically supplied. 


2. Define <KP3> to be the SET DEFAULT command. Create a subdirectory. Try to move to 
the subdirectory by using your newly defined key. 


S$ DEFINE/KEY KP3 "SET DEFAULT " 
$ CREATE/DIRECTORY [SMITH.TEMPORARY] 


Press <KP3> key, type in [SMITH. TEMPORARY] and press <RET> key. To see if it worked, 
issue the SHOW DEFAULT command. 


3. Delete the key definition for <KP2>. See if it worked by displaying all your key definitions 
again. 


§ SHOW KEY/ALL (Displays all key definitions) 
S$ DELETE/KEY KP2 
$ SHOW KEY/ALL 
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WRITTEN EXERCISE | 


Part A: 


Each command below uses a symbol in some way. Indicate whether or not the symbol is used 
correctly. If it is used correctly, rewrite the command, replacing the symbol with its value. If the 
symbol is used incorrectly, rewrite the command correctly. 


i 


$ FILE = ’FILE NAME’ + ’/FILE TYPE’ 
Incorrect. Correct command is: $ FILE = FILE_NAME + FILE TYPE 


Do not use symbol substitution characters on the right-hand side of an = assignment state- 
ment. | 


S$ WRITE SYSSOUTPUT COUNT " copies of the file" 
Incorrect. Correct command is: $ WRITE SYSSOUTPUT COUNT, " copies of the file" 


Separate the items in the output list with commas. The values will be concatenated. Note 
that the symbol COUNT is substituted automatically. 


An alternate method: s wRITE sySSOUTPUT "’’ COUNT’ copies of the file" 


If you place the symbol COUNT within the quoted string, symbol substitution does not occur 
automatically. For symbol substitution to occur, precede the symbol with two apostrophes. 


$ IF COUNT .LT. 10 THEN GOTO END 

Correct. $ IF 2 .LT. 10 THEN GOTO END 

DCL automatically performs symbol! substitution in an IF command. 
$ WRITE SYSSOUTPUT "The file ’ ae ee ‘'PILE TYPE" 

Correct. $ WRITE SYSSOUTPUT "The file PROGRAM.FOR" 


In a character string, a symbol must be preceded by two apostrophes and followed by one. 
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Part B: 


in the commands below, replace the underlined text with symbols, using the proper symbol 
substitution techniques. Use the same symbol values you used in Part A. 


1. $ WRITE SYSSOUTPUT "The file is MYFILE.TXT" 
$ WRITE SYSSOUTPUT "The file is ’’P1’" 


2. S$ TYPE PROGRAM.FOR 
$ TYPE ’FILE_NAME’ FILE TYPE’ 


3. S$ EDIT DATA.DAT 
$ EDIT 'P2’ 


4. $ WRITE SYSSOUTPUT "2 copies of the file DATA.DAT exist." 
S$ WRITE SYSSOUTPUT "’ ’COUNT’ copies of the file ’’P2’ exist." 


5. $ FILE = "PROGRAM" +". FOR" 
$ FILE = FILE NAME + FILE TYPE 


11--86 EXERCISES 


LABORATORY EXERCISE | 


2 LOGIN.COM 

$! 

$! 

S! Check to see if process is interactive. If not, exit. 
S$! 

S$ IF FSMODE() .NES. "INTERACTIVE" THEN EXIT 

S$! 

S$! Define a logical name that points to the 

$! CQMPROC subdirectory. 


S$! 

S$ DEFINE COMPROC DISK1: [MANN.COMPROC] 

$! 

S$! Alternately, use ASSIGN DISK1: [MANN.COMPROC] COMPROC 

$! 

$! Set up global symbols to be used a command synonyms 

3! 

S$ SED == "SET DEFAULT" ' Resets default 

S$ WHO == "SHOW USERS" ! Displays all users 
S$ SHD == "SHOW DEFAULT" ! Displays current directory 
S$ HOME == "SET DEFAULT SYSSLOGIN" ! Resets default to login values 
$! 

S$! Display some "time and place" information on the terminal 
$! 

$ SHOW TIME 

$! 

$ SHOW DEFAULT 

$! 

S$! Leave the procedure in an orderly manner. 

$! 

S. .EXLT 
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LABORATORY EXERCISE II 


Ss! CREATE FILE.COM 

$! 7 

$! 

S$! Expected parameters: Pl = name of file to be edited 
Ss! 


S$! This command procedure allows you to edit a file, sets the 
S$! protection on the file so that the World has READ access, 
S! then gives you the option of printing a copy of it. 

of 

S! Be sure the name of the file is assigned to Pl. If not, ask: 
=! a 
S IF Pl .EQS. "" THEN INQUIRE Pl "Filename" 
Ss! 

S$! Display a message that indicates what file is being created: 
S$! 

S WRITE SYSSOUTPUT " " 

S WRITE SYSSOUTPUT "Editing the file '’P1’..." 

S WRITE SYSSOUTPUT " " 

Ss! : 

S! Redirect SYSSINPUT so that it points to the terminal: 
$! : 
S$ DEFINE/USER_MODE SYSSINPUT SYSSCOMMAND 

S$! 

$! Alternately, ASSIGN/USER_MODE SYSSCOMMAND SYSSINPUT 
2 

S$! Allow the user to edit the file: 

$! 

5 EDIT.“ P i’ 

= 


S$! Set the required protection for the file: 


Ss! 

S SET PROTECTION=(W:R) ’P1’ 

S$! 

$! Present the option of printing the file: 
S! 


S INQUIRE/NOPUNCTUATION ANS "Print a copy of the file? " 
S$ IF ANS THEN PRINT ’P1’ 
S$ EXIT 
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4 
: 
} 
i 
: 
i 
i 
: 
: 


BACK SOON.COM 


This command procedure asks the user how many minutes he/she will 
be away. It erases the screen and displays the message "Back in 
‘n’ minutes". It waits a minute, recalculates the value of N, and 
redisplays the message. When only one minute is left, it displays 
"I will be right back". 


Inquire for the number of minutes the user intends to be away. 


WHEN : 
INQUIRE/NOPUNCTUATION BACKSOON "How many minutes? " 


; 
i 


If no answer, ask again. 


IF BACKSOON .EQS. "" THEN GOTO WHEN 


f 
! 


Top of time loop 


LOOP : 
IF .BACKSOON .EQ. 1 THEN GOTO RIGHTBACK 


: 
: 


Erase the screen 


SET TERMINAL/WIDTH=80 


: 
t 
: 


Use the TYPE SYSSINPUT command to type eleven blank lines on 
the terminal. 


TYPE SYSSINPUT 
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' Now use the WRITE SYSSOUTPUT command to display 
' the message on the screen. 
t 


WRITE SYSSOUTPUT " Back in '’BACKSOON’ minutes" 
! 

! Wait one minute--note that the terminal is 
! tied up with this procedure. 

WAIT 00:01:00.00 

t . 

' Subtract 1 from the number of minutes 
BACKSOON=BACKSOON - 1 

' Loop until only one minute is left. 

GOTO LOOP 

! The last step 

RIGHTBACK: 

' 

! Erase the Screen 

TYPE/PAGE NL: 

t 

! Use the TYPE SYSSINPUT command to type 

! the necessary blank lines. 

TYPE SYSSINPUT 


DADAM MOM MNMNNUMN ADH NUMHHNOM HMMM MA MH 


! 


WRITE SYSSOUTPUT " I will be right back." 
END: 
EXIT 


MINN MH 
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USING DISK AND TAPE VOLUMES—SOLUTIONS 


WRITTEN EXERCISE | 


The list below contains the major steps that you must complete to create and use a private 
volume. Indicate the order of these steps by writing the appropriate number in the space that 
precedes each one. | 


1. 


2 
3 
4 
5. 
6 
7 


Allocate device 
Deallocate device 
Dismount volume 
Initialize volume 
Load volume 


Mount volume 


. Unload volume 
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Choose the VMS command best suited to perform each of the following operations and write its 
letter in the space provided. 


VMS Commands 
a. ALLOCATE 
b. DEALLOCATE 
c. DISMOUNT 


d. INITIALIZE 
e. MOUNT 


f. SHOW DEVICE/FULL 

















Operations 

1. d Build the appropriate structure on a disk (usually used for a new tape). 
2 Cc Terminate access by your process to the contents of a volume. 

3 f Display the owner UIC and protection code of a volume. 

4. e Initiate access by your process to the contents of a volume. 

5 b Release a device from exclusive use by your process. | 

. | 





a Reserve a device for exclusive use by your process. 
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1. Allocate any available tape unit to your process and assign the logical name TAPE to it. 


S$ ALLOCATE MT: TAPE 


2. Initialize a tape volume that you have loaded on TAPE. Assign the label TAP_BK to the unit. 


S INITIALIZE TAPE TAP_BK 


3. Mount TAP_BK on the tape device so that the Backup utility can process it. 


$ MOUNT/FOREIGN TAPE 


4. Back up all files in your default directory to a save set on TAP_BK. 


S BACKUP /IGNORE=LABELPROCESSING [...]*.*;* TAPE: TAP BK.BCK 


5. List the contents of the save set TAP_BK at your terminal. 


$ BACKUP/LIST TAPE:TAP_BK.BCK 


6. Terminate access to TAP_BK, allowing the system to automatically unload the volume. 


S$ DISMOUNT TAPE 


7. Release the tape device so others on your system can use it. 


$ DEALLOCATE TAPE 


8. Delete the logical name TAPE from the logical name table that stores it. 


S$ DEASSIGN TAPE 
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LABORATORY EXERCISE | 
Complete the following exercises at an interactive terminal. Note that your device names may 
differ from the device and directory names given in the solutions. 


as 


1. Allocate the tape. 


$ ALLOCATE MTAO: 


2. Initialize the tape, giving it a label name of MYTAPE. 


S INITIALIZE MTAO: MYTAPE 


3. Mount the tape, so that BACKUP can be used. 


$ MOUNT/FOREIGN MTAO: 


4. Obtain a listing of the files in your directory. 


S$ DIRECTORY 


5. Transfer all files from your directory to the tape. 


$ BACKUP/IGNORE=LABEL PROCESSING *.*;* MTAO:JAN1.BCK 


6. Confirm that ail files transferred successfully to the tape. 


$ BACKUP /REWIND/LIST MTAO:JAN1.BCK 


7. Dismount the tape. 


$ DISMOUNT MTAO: 


8. Deallocate the tape. 


S DEALLOCATE MTAO: 
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SUBMITTING BATCH AND PRINT JOBS—SOLUTIONS : 


Fat 
La © 


LABORATORY EXERCISE | 


1. Choose a text file and print it, using the generic print queue SYS$PRINT. 


S PRINT filename 
(Filename is the name of your file in all solutions.) 


2. Use a single PRINT command to print two copies of the same file. 


S PRINT/COPIES=2 filename 


3. Display a list of all queues on your system and all jobs in the queues. 


$ SHOW QUEUE/ALL ENTRIES 


4. Select an execution queue from the queue display. (An execution queue will have the same 
name as its associated device, without the colon.) Print the same file, queuing it directly to 
the physical queue. 


$ PRINT/QUEUE=LPAO filename 


(LPAO may or may not be the name of your physical queue, depending upon how the system 
is set up.) ns 


5. Choose two text files. Print these two files so that you get two copies of the first file and 
three copies of the second file. 


PRINT firstfilename/COPIES=2, secondfilename/COPIES=3 


wn 


see ue 
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6. Send a text file to the print queue, requesting that the file not be printed until an hour from 
now. | iia 


PRINT/AFTER=TIME filename 


7. Display the queue status of the job waiting to be printed. Delete this job from the queue. 


SHOW QUEVE SYSSPRINT 
DELETE/ENTRY=ENTRY-NUMBER SYSSPRINT 
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LABORATORY EXERCISE II 


1. Display at your terminal screen all of the batch queues on the system. 


S$ SHOW QUEUE/BATCH 
2. Submit a command procedure to batch that displays the time, displays all processes on the 
system, and shows all logicai names on the system.: Save the log file. You will need to 
examine it shortly. 


$1 NaME OF .COM FILE oe 
$! 
S$ SHOW TIME 
_ 38 SHOW.SYSTEM 
- § SHOW LOGICAL 
Saxo 
3. Submit the above command procedure to batch so that the log file will not be printed. 
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$ SUBMIT/NOPRINTER FILENAME.COM 


4. Submit the above command procedure to batch so that the jog file will not be created. 


$ SUBMIT/NOLOG FILENAME .COM 
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Examine the log file created in Step 2. Answer the following SUE SNe Ss 


Find the entry for your batch job from the SHOW SYSTEM command. What was its — 
process ID? 


Did your LOGIN.COM file execute? Did the system-wide login procedure execute? 
How mucn ie time ? did your pelr job use to execute? | | 


cane fk ath ee 


How much elapsed time did your batch job use to execute? 


Your batch name entry should have a name similar to BATCHXXX (XXX would be the ID number 
of your job). Also in the right margin of the SHOW SYSTEM display, you should see the letter 
B. 


The entries marked with a B are batch jobs. Both your LOGIN.COM file and the system-wide login 
procedure should have executed, assuming oy exist. You may see some of your LOGIN.COM 
file commands in the ‘og We 


Both the CPU time and slapssat time are in the accounting information in the last lines of the log 


file. 
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TEST 


Underline the best answer to each of the following questions. 


1. When logging in to a VMS system, you typically need to supply your: 
a. User identification code and user name 
b. User name and password 
c. User identification code and password 
d. User identification code, user name, and password 
2. Which DCL command displays a text file on the terminal screen? 
a. EXAMINE 
b. TYPE 
c. SHOW. 
d. DIRECTORY 
3. Which command can move a file from one disk to another? 
a. RENAME 
b. COPY 
c. CREATE 
d. CONVERT 


4. Your default directory is [JOHNSON]. Which of the ens DCL commands creates the 
subdirectory [JOHNSON.BUDGET]? 


a. CREATE/SUBDIRECTORY [JOHNSON.BUDGET] 
b. CREATE/DIRECTORY [JOHNSON.BUDGET] 
c. CREATE/DIRECTORY [JOHNSON]BUDGET.DIR 
d. CREATE/SUBDIRECTORY BUDGETDIR 
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a. Delete-all the files:in.the subdirectory. 
b. Log in to the. SYSTEM account. 


c. -Make- backup. copies of.the files in the subdirectory:>~. 


d. . Notify..other users on the system that you are deleting the subdirectory. 


6. Which BCE command do you use to put a job in a batch — | 
a. SEND/BATCH Pee Tee 
b. BATCH’. 
c. SUBMIT 
d. QUEUE/BATCH 


7. ~Which, DCL command, do you use to put a | Job ina a. eee 
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a. .SEND/PRINT 
—b. .PRINT 

c. SUBMIT — 
d. QUEUE/PRINT 


8. ever of the ne bela you to use the oe command? - 
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a. Defining a DCL symbol ” 
b. -Creating a new user name so 
c. -Defining-a logical name 


d. Setting:a file’s protection | ~ oe 
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What must-you do: before the VMS system will allow you-to. dglete a subdirectory? 


hd 


4 


lf a logical name-is already: défined;*which command do you use to assigri a neW value to - 
the logical name? 


ma a 

a. RENAME : 
a mn ae 4 

b. DEASSIGN - 

PES EID S EOD UMNESS a8 
c. CREATE a 
d. ASSIGN | ¥ 
oka at fawn. vane. 43 a coppice ~# a See ree Fe 
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lf a file already exists, whic command do you use to assign a new name 2 to the fle? 
a. RENAME 
b. DEASSIGN 


c. CREATE se, ie - 
a ae. ta r 
d. ASSIGN : | 
ide Te hes a eed 3 MEG res ae Seer cs PVA ace 
Which logical name refers to the disk and diredony that are > the default when you oa i in? 
a. SYS$COMMAND bees Bee 
b. SYS$LOGIN ae 
c. SYS$INPUT ; 22 


d. SYSSOUTPUT . 


a = wr: Bae — o..5 “s ae ete 


‘Which of the following DCL connate defines the symbol GO as s the Del command 4 SET 
DEFAULT? © pe : ao 


a. SET DEFAULT == "GO" | On Qa xat oot PR 4 


b. ‘"“GO" == "SET DEFAULT" | | | aes a ee ee. coosmie EST ie us 
c. GO =="SET DEFAULT" WEG ead £ p:dHhen. 
d. "SET DEFAULT” == GO 
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13. Which of the following do you use to assign.a global value to a symbol name? . 


a = 


ae, Ce Np ®es P 
=——s aan . 
b. = a ae oes & Myo 
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Mee Poe BE CL Rie cae 
c. DEFINE | atta 
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d. DEFINE/GLOBAL 
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14. Which of the following operators would you use, to test phy ¢ character strings are equal 


following an IF command in a DCL command procedure’ 


a = 
b, == 

qve 
c.. ,60; “ 
d. .EQS. 


15. Ina DCL command procedure, a label is followed by which of the following characters? | 


d. space 
16. Which DCL command do you use to display your password? 
a. EXAMINE PASSWORD 
b. SHOW PASSWORD 
c. SHOW PROCESS/PASSWORD 


d. There is no command to do this 
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17. Which DCL cominand dé you use to“change ‘your password? -§ "0 Gia’ tir. 
a. RENAME PASSWORD 
b. CHANGE PASSWORD = 
c. SET PASSWORD a oe 
d. There is no command to do this ee) ee 


18: ‘The DCE command that télmindtés 2 process is: 
SSIS PS bee * 
a. LOGOUT 
b. EXIT 


c. DELETE 
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d. QUIT 
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Match each of the following DCL commands with its function. You will not use all’ Ok the DCL “a 
commands. 


by ae es Se Aer foie 
DCL Command ~ a : 
me 3G IBS DG vz . 
a. START 
OPE We Loe ghost reat yotiers 
b. @ 
| mi segc ff eTar c 
c. SUBMIT : Saar oh SO 
a ae so ae ae He . 
d. CREATE 
TOWER GB oe TEL “argh Ve Bo! 7 
e. RUN 
| Sie Pee hs So? er S VE.Je 4 re urae y 
Function 
SV AeA Ot 
1. Execute a compiled and linked program 
| ~~ ae 
2. Execute a command procedure in batch mode 
| Sr ie 
3. Execute a command procedure interactively 
i. tee 


Match the VMS system component | with its function... You Inay, select. a System component ¢ gnce, . 
more than once, or not at all. 


VMS System Component ay RP OB 

a. CPU | Jee 

b. I/O Interface BRET 4G 

c. Disk Drive ca) =D 
ont ss * elalicates (es et® Seta ee a eee Fe ee el ot 3) me : ee: 

a PryccalMemen — ee ee CTEDOUE WORN oy. pier ae e 

SMI Memory “SCue ou Vea cee 2 

Function TE EA MO_LMMS.) AOTORR 9 TABE Yc 

1. _ The system component typically: used by the.hardware wher teferring to memory 

2. ___—sqOwThe system component typically wsed’ by a programmer when referring to memory 

3. ______—sxThe pathway through which data is transferred to other hardware devices 

4. _______ The only system component that performs computations 

5. | The only system component that is conceptual, and not a piece of hardware 
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Underline the best answer to each of the following questions. 


1. 


3. 


x noe “ICREATE/SUBDIRECTORY BUBGET.DIR + ‘62 > MEAOGTOT meraye ent 
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Which command can move a filé trot one disk to ‘another?> | 


When logging in to a VMS system, you typically need to supply your: 
a. User identification code and user name 


b. User name and password | 


c. User identification code and password 
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d. User identification code, user name, and password 


Which DCL command displays a text file on the terminal screen? 
| CPOE st 


a. EXAMINE 
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b. COPY 
c. CREATE | | Sree es 


d. CONVERT 
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Your default directory is [JOHNSON]. Which of the following DCL oa creates the 
subdirectory (JOMNSON. BUDGET]? femme’ geo oen€ 


a. CREATE/SUBDIRECTORY [JOHNSON.BUDGET] a ae 


CREATE/DIRECTORY [JOHNSON.BUDGET] Ae 1g0es 
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Log in to the SYSTEM account. ; 
Make backup copies of the files in the subdirectory. 


d. Notify other users on the system that you are deleting the subdirectory. 


Which DCL command do you use to put a job in a batch eens 
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a. SEND/BATCH = 


b. BATCH _ a Abs 


c. SUBMIT eee 
d. QUEUE/BATCH STA? 


. Which DCL command do is use to put a job in a print = 
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Delete all the files in the subdirecto ae ee 
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c. Defining a logical name SATS G “ge. CORT Ce 
d. Setting a file’s protection PIPE SS ae SS oe 
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If a logical name i$ already defined, which command do you 
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lf a file already exists, which command do you use to assign 


a. RENAME 


b. DEASSIGN 


c. CREATE 


d. ASSIGN demi tsiac: 
" : BYE CR a ee: ee 


a. SYSS$COMMAND 


b. SYS$LOGIN 


c. SYSSINPUT 


d. SYSSOUTPUT LYE ry p.” “8 laste & mt as ts ( mony wo be 


Which of the following DCL commands defines the silica GO. as {he PCL. command SET 


DEFAULT? 


a. SET DEFAULT == "GO" 7 SF 


b. "GO" == "SET DEFAULT" 


c. GO == "SET DEFAULT 


"SET DEFAULT" == GO 
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Which logical name refers to the disk and eeey that are the default when, yOu leg n?. 
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14. 


15. 


16. 


a = re Bee ee z 
b. == | i eee rae: ae 
¢. DEFINE CRONE 
d. DEFINE/GLOBAL ~ | 2 Oey Sere sa is 
Which of the following operators would you usét6 test F tWo ‘characte strings are etal 


following an IF command in a DCL command procedure? 


b. = = 
c .EQ. 
d. .EQS. 


Ina DCL command procedure, a label is followed by which of the following characters? 


a - 
b. §$ 
C.F 
d. space 


Which DCL command do you use to display your password? 


a. EXAMINE PASSWORD 
b. SHOW PASSWORD 
c. SHOW PROCESS/PASSWORD 


d. There is no command to do this 
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17. Which DCL conamand.do: you-useto change: your, password?,, | 


a. 
b. 
Cc. 


d. 


18. <The AGL commanad-that-terminates.a process is: ., 
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a. 
b. 


c. 


RENAME PASSWORD 
CHANGE PASSWORD 
SET PASSWORD 


There is no command to do this 
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LOGOUT 
EXIT 
DELETE 
QUIT 
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Test B-3 ase 


Match each of the following: DCL commands’ with its function. You-will -not-use:all of the:DCL. 
commands:. | | 


DCL.Command: 


a. 


b. 


c: 


d.. 


@:. 


START 
@ 


SUBMIT 


CREATE: 
RUN: 


Function: 


Ti. 
yk 


e _. Executéaicompited and:linked program 
_¢.._. Execute’a command:procedure:in batch moder: 


b= Execute a:command procedure interactively. 


Matttr the: VMS systerr-component with its.function. You may;setecta system component:once,, 


‘More than ore, or notat-all. 


VIS: SystenrComponent: 


ai. 
bi. 
di... 


&. 


CPU. 
V/O- Interface: 


(Disk Drive. 


Physical Memory: 


Virtual Memrary. 


Function: . 


t. 


dad. The:systerrcn 





ponent typically used by the: hardware: wher referring: ta: memary. 








_&. The-system component typicaily: used by a programmer:whern. referring to memory 


| : _b The: pathway through’ whict? data. is transferred: to: otter: hardware: devices: 





a. Theoniy system componentittat: performs computations: » 








_&  =‘The orily system’. componentithat'is conceptual, and nota: piece of hardware: 


